Updating readme.md files for SDK generation (multi-api, new api version already checked in)

specification/mysql/resource-manager/readme.az.md

@@ -0,0 +1,14 @@
+## AZ
+
+These settings apply only when `--az` is specified on the command line.
+
+``` yaml $(az)
+az:
+    extensions: mysql
+    namespace: azure.mgmt.mysql
+    package-name: azure-mgmt-mysql
+az-output-folder: $(azure-cli-extension-folder)/src/mysql
+python-sdk-output-folder: "$(az-output-folder)/azext_mysql/vendored_sdks/mysql"
+# add additinal configuration here specific for Azure CLI
+# refer to the faq.md for more details
+```

specification/mysql/resource-manager/readme.csharp.md

@@ -0,0 +1,103 @@
+### C#
+
+These settings apply only when `--csharp` is specified on the command line.
+Please also specify `--csharp-sdks-folder=<path to "SDKs" directory of your azure-sdk-for-net clone>`.
+
+``` yaml $(csharp)
+csharp:
+  azure-arm: true
+  license-header: MICROSOFT_MIT_NO_VERSION
+  clear-output-folder: true
+```
+
+### C# multi-api
+
+Generate all API versions currently shipped for this package
+
+```yaml $(multiapi)
+batch:
+  - tag: package-2020-01-01
+  - tag: package-2018-06-01
+  - tag: package-2017-12-01
+  - tag: package-2020-07-01-privatepreview
+  - tag: package-2020-01-01-privatepreview
+  #- tag: package-2018-06-01-privatepreview # commenting this out as there is an issue with 'ProxyResources'
+  - tag: package-2017-12-01-preview
+```
+
+### Tag: package-2020-01-01 and C#
+
+These settings apply only when `--tag=package-2020-01-01 --csharp` is specified on the command line.
+Please also specify `--csharp-sdks-folder=<path to the root directory of your azure-sdk-for-net clone>`.
+
+``` yaml $(tag) == 'package-2020-01-01' && $(csharp)
+csharp:
+  namespace: Microsoft.Azure.Management.MySQL
+  output-folder: $(csharp-sdks-folder)/mysql/$(namespace)/src/Generated
+```
+
+### Tag: package-2018-06-01 and C#
+
+These settings apply only when `--tag=package-2018-06-01 --csharp` is specified on the command line.
+Please also specify `--csharp-sdks-folder=<path to the root directory of your azure-sdk-for-net clone>`.
+
+``` yaml $(tag) == 'package-2018-06-01' && $(csharp)
+csharp:
+  namespace: Microsoft.Azure.Management.MySQL
+  output-folder: $(csharp-sdks-folder)/mysql/$(namespace)/src/Generated
+```
+
+### Tag: package-2017-12-01 and C#
+
+These settings apply only when `--tag=package-2017-12-01 --csharp` is specified on the command line.
+Please also specify `--csharp-sdks-folder=<path to the root directory of your azure-sdk-for-net clone>`.
+
+``` yaml $(tag) == 'package-2017-12-01' && $(csharp)
+csharp:
+  namespace: Microsoft.Azure.Management.MySQL
+  output-folder: $(csharp-sdks-folder)/mysql/$(namespace)/src/Generated
+```
+
+### Tag: package-2020-07-01-privatepreview and C#
+
+These settings apply only when `--tag=package-2020-07-01-privatepreview --csharp` is specified on the command line.
+Please also specify `--csharp-sdks-folder=<path to the root directory of your azure-sdk-for-net clone>`.
+
+``` yaml $(tag) == 'package-2020-07-01-privatepreview' && $(csharp)
+csharp:
+  namespace: Microsoft.Azure.Management.MySQL.FlexibleServers
+  output-folder: $(csharp-sdks-folder)/mysql/$(namespace)/src/Generated
+```
+
+### Tag: package-2020-01-01-privatepreview and C#
+
+These settings apply only when `--tag=package-2020-01-01-privatepreview --csharp` is specified on the command line.
+Please also specify `--csharp-sdks-folder=<path to the root directory of your azure-sdk-for-net clone>`.
+
+``` yaml $(tag) == 'package-2020-01-01-privatepreview' && $(csharp)
+csharp:
+  namespace: Microsoft.Azure.Management.MySQL
+  output-folder: $(csharp-sdks-folder)/mysql/$(namespace)/src/Generated
+```
+
+### Tag: package-2018-06-01-privatepreview and C#
+
+These settings apply only when `--tag=package-2018-06-01-privatepreview --csharp` is specified on the command line.
+Please also specify `--csharp-sdks-folder=<path to the root directory of your azure-sdk-for-net clone>`.
+
+``` yaml $(tag) == 'package-2018-06-01-privatepreview' && $(csharp)
+csharp:
+  namespace: Microsoft.Azure.Management.MySQL
+  output-folder: $(csharp-sdks-folder)/mysql/$(namespace)/src/Generated
+```
+
+### Tag: package-2017-12-01-preview and C#
+
+These settings apply only when `--tag=package-2017-12-01-preview --csharp` is specified on the command line.
+Please also specify `--csharp-sdks-folder=<path to the root directory of your azure-sdk-for-net clone>`.
+
+``` yaml $(tag) == 'package-2017-12-01-preview' && $(csharp)
+csharp:
+  namespace: Microsoft.Azure.Management.MySQL
+  output-folder: $(csharp-sdks-folder)/mysql/$(namespace)/src/Generated
+```

specification/mysql/resource-manager/readme.go.md

@@ -13,11 +13,21 @@ go:
 
 ``` yaml $(go) && $(multiapi)
 batch:
+  - tag: package-2020-07-01-privatepreview
   - tag: package-2020-01-01
   - tag: package-2017-12-01-preview
   - tag: package-2017-12-01
 ```
 
+### Tag: package-2020-07-01-privatepreview and go
+
+These settings apply only when `--tag=package-2020-07-01-privatepreview --go` is specified on the command line.
+Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.
+
+``` yaml $(tag) == 'package-2020-07-01-privatepreview' && $(go)
+output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/flexible-servers/2020-07-01-privatepreview/$(namespace)
+```
+
 ### Tag: package-2020-01-01 and go
 
 These settings apply only when `--tag=package-2020-01-01 --go` is specified on the command line.

specification/mysql/resource-manager/readme.md

@@ -153,45 +153,11 @@ swagger-to-sdk:
 
 ### C#
 
-These settings apply only when `--csharp` is specified on the command line.
-Please also specify `--csharp-sdks-folder=<path to "SDKs" directory of your azure-sdk-for-net clone>`.
-
-``` yaml $(csharp)
-csharp:
-  azure-arm: true
-  license-header: MICROSOFT_MIT_NO_VERSION
-  namespace: Microsoft.Azure.Management.MySQL
-  output-folder: $(csharp-sdks-folder)/mysql/Microsoft.Azure.Management.MySQL/src/Generated
-  clear-output-folder: true
-```
-
+See configuration in [readme.python.md](./readme.csharp.md)
 
 ## Python
 
-These settings apply only when `--python` is specified on the command line.
-Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
-Use `--python-mode=update` if you already have a setup.py and just want to update the code itself.
-
-``` yaml $(python)
-python-mode: create
-python:
-  azure-arm: true
-  license-header: MICROSOFT_MIT_NO_VERSION
-  payload-flattening-threshold: 2
-  namespace: azure.mgmt.rdbms.mysql
-  package-name: azure-mgmt-rdbms
-  clear-output-folder: true
-```
-``` yaml $(python) && $(python-mode) == 'update'
-python:
-  no-namespace-folders: true
-  output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql
-```
-``` yaml $(python) && $(python-mode) == 'create'
-python:
-  basic-setup-py: true
-  output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms
-```
+See configuration in [readme.python.md](./readme.python.md)
 
 ## Go
 

specification/mysql/resource-manager/readme.python.md

@@ -0,0 +1,107 @@
+## Python
+
+These settings apply only when `--python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+Use `--python-mode=update` if you already have a setup.py and just want to update the code itself.
+
+```  yaml $(python) 
+python:
+  azure-arm: true
+  license-header: MICROSOFT_MIT_NO_VERSION
+  payload-flattening-threshold: 2
+  package-name: azure-mgmt-rdbms
+  clear-output-folder: true
+  no-namespace-folders: true
+```
+
+### Python multi-api
+
+Generate all API versions currently shipped for this package
+
+```yaml $(multiapi)
+batch:
+  - tag: package-2020-01-01
+  - tag: package-2018-06-01
+  - tag: package-2017-12-01
+  - tag: package-2020-07-01-privatepreview
+  - tag: package-2020-01-01-privatepreview
+  # - tag: package-2018-06-01-privatepreview # commenting this out as there is an issue with 'ProxyResources'
+  - tag: package-2017-12-01-preview
+```
+
+### Tag: package-2020-01-01 and python
+
+These settings apply only when `--tag=package-2020-01-01 --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2020-01-01' && $(python)
+python:
+  namespace: azure.mgmt.rdbms.mysql
+  output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql
+```
+
+### Tag: package-2018-06-01 and python
+
+These settings apply only when `--tag=package-2018-06-01 --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2018-06-01' && $(python)
+python:
+  namespace: azure.mgmt.rdbms.mysql
+  output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql
+```
+
+### Tag: package-2017-12-01 and python
+
+These settings apply only when `--tag=package-2017-12-01 --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2017-12-01' && $(python)
+python:
+  namespace: azure.mgmt.rdbms.mysql
+  output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql
+```
+
+### Tag: package-2020-07-01-privatepreview and python
+
+These settings apply only when `--tag=package-2020-07-01-privatepreview --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2020-07-01-privatepreview' && $(python)
+python:
+  namespace: azure.mgmt.rdbms.mysql.flexibleservers
+  output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql/flexibleservers
+```
+
+### Tag: package-2020-01-01-privatepreview and python
+
+These settings apply only when `--tag=package-2020-01-01-privatepreview --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2020-01-01-privatepreview' && $(python)
+python:
+  namespace: azure.mgmt.rdbms.mysql
+  output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql
+```
+
+### Tag: package-2018-06-01-privatepreview and python
+
+These settings apply only when `--tag=package-2018-06-01-privatepreview --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2018-06-01-privatepreview' && $(python)
+python:
+  namespace: azure.mgmt.rdbms.mysql
+  output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql
+```
+
+### Tag: package-2017-12-01-preview and python
+
+These settings apply only when `--tag=package-2017-12-01-preview --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2017-12-01-preview' && $(python)
+python:
+  namespace: azure.mgmt.rdbms.mysql
+  output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql
+```

specification/postgresql/resource-manager/readme.az.md

@@ -0,0 +1,14 @@
+## AZ
+
+These settings apply only when `--az` is specified on the command line.
+
+``` yaml $(az)
+az:
+    extensions: postgresql
+    namespace: azure.mgmt.postgresql
+    package-name: azure-mgmt-postgresql
+az-output-folder: $(azure-cli-extension-folder)/src/postgresql
+python-sdk-output-folder: "$(az-output-folder)/azext_postgresql/vendored_sdks/postgresql"
+# add additinal configuration here specific for Azure CLI
+# refer to the faq.md for more details
+```