Merge pull request Azure#15 from amarzavery/master

Merging changes from public repo to private

README.md

@@ -12,6 +12,8 @@ This repository is the canonical source for REST API specifications for Microsof
 ## Creating the Swagger Specification for Azure
 - This [document](./documentation/creating-swagger.md) will help you understand how AutoRest converts Swagger in to code.
 - If you are using **swashbuckle** to generate a swagger spec from your .NET WEB API then please take a look at this [repo]( https://github.com/Azure/swashbuckle-resource-provider).
+- Swagger spec for every api-version should be in a serate folder named with the api-version.
+  - It is time consuming to review the file line by line for every api-version. When you are creating the swagger spec for the new api-version, please copy the swagger spec from the previous version in to the new api-versioned folder and commit it. After that overwrite it with the changes for the new api-version. This makes it easy for us to review the changes.
 
 ## Directory Structure
 

arm-commerce/2015-06-01-preview/swagger/commerce.json

@@ -447,7 +447,7 @@
       "in": "path",
       "required": true,
       "type": "string",
-      "description": "It uniquely identifes Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
+      "description": "It uniquely identifies Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
     },
     "ApiVersionParameter": {
       "name": "api-version",

arm-compute/compositeComputeClient.json

@@ -4,7 +4,7 @@
     "description": "Composite Swagger for Compute Client"
   },
   "documents": [
-    "./arm-compute/2016-03-30/swagger/compute.json",
-    "./arm-compute/2016-03-30/swagger/containerService.json"
+    "./2016-03-30/swagger/compute.json",
+    "./2016-03-30/swagger/containerService.json"
   ]
 }

arm-compute/quickstart-templates/swagger.json

@@ -129,9 +129,6 @@
           ]
         }
       },
-      "required": [
-        "mode"
-      ],
       "description": "Deployment properties."
     },
     "Deployment": {

arm-datalake-analytics/catalog/2015-10-01-preview/swagger/catalog.json

@@ -2304,7 +2304,11 @@
       ],
       "properties": {
         "columns": {
-          "$ref": "#/definitions/TypeFieldInfo",
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/TypeFieldInfo"
+          },
           "description": "the type field information associated with this table type."
         }
       },