diff --git a/specification/storagepool/resource-manager/readme.az.md b/specification/storagepool/resource-manager/readme.az.md
new file mode 100644
index 000000000000..d0f6bac0405f
--- /dev/null
+++ b/specification/storagepool/resource-manager/readme.az.md
@@ -0,0 +1,38 @@
+## AZ
+
+These settings apply only when `--az` is specified on the command line.
+
+``` yaml $(az)
+az:
+    extensions: diskpool
+    namespace: azure.mgmt.storagepool
+    package-name: azure-mgmt-storagepool
+az-output-folder: $(azure-cli-extension-folder)/src/diskpool
+python-sdk-output-folder: "$(az-output-folder)/azext_diskpool/vendored_sdks/storagepool"
+# add additinal configuration here specific for Azure CLI
+# refer to the faq.md for more details
+```
+
+## Az.DiskPool
+
+``` yaml
+cli:
+  cli-directive:
+      - where:
+          param: disks
+        set:
+          positional: true
+          positionalKeys:
+            - id
+      - where:
+          group: DiskPools
+          op: ListOutboundNetworkDependenciesEndpoints
+        hidden: true
+      - where:
+          group: DiskPools
+          parameter: additionalCapabilities
+        alias:
+          - additional_capabilities
+          - a
+
+```
\ No newline at end of file
diff --git a/specification/storagepool/resource-manager/readme.cli.md b/specification/storagepool/resource-manager/readme.cli.md
new file mode 100644
index 000000000000..813847914ab1
--- /dev/null
+++ b/specification/storagepool/resource-manager/readme.cli.md
@@ -0,0 +1,21 @@
+``` yaml
+# add any configuration here for all CLI languages
+# refer to the faq.md for more details
+directive:
+    - where:
+        group: diskpool disk-pool
+      set:
+        group: disk-pool
+    - where:
+        group: diskpool iscsi-target
+      set:
+        group: disk-pool iscsi-target
+    - where:
+        command: disk-pool deallocate
+      set:
+        command: disk-pool stop
+    - where:
+        command: diskpool disk-pool-zone list
+      set:
+        command: disk-pool list-skus
+```
\ No newline at end of file