minor tweaks

amarzavery · amarzavery · commit 18f2597b8d65 · 2015-12-11T15:49:29.000-08:00
diff --git a/documentation/creating-swagger.md b/documentation/creating-swagger.md
@@ -387,7 +387,7 @@ theResource.Location = "North US";
 theResource.Foo.Name = "fooB";
 theResource.Foo.Capacity = 100;
 ```
-### When will AutoRest flatten resources
+### When will AutoRest flatten resources?
 If any model or its parent is marked with an extension `"x-ms-azure-resource" : true`, then AutoRest will flatten the 
 Resource-specific properties by one level for that model.
 
@@ -497,11 +497,13 @@ Swagger as the list of items and the `nextLink`. Tag the operation as `x-ms-page
 methods for navigating between pages.
 
 #### x-ms-pageable extension definition
-```json
+```
 {
   "x-ms-pageable" : {
-    "nextLinkName": "Specify the name of the property that provides the nextLink. If your model does not have the nextLink property then specify null.",
-    "itemName": "Specify the name of the property that provides the collection of pageable items. It is optional. Default value is 'value'." 
+    "nextLinkName": "Specify the name of the property that provides the nextLink. 
+                     If your model does not have the nextLink property then specify null.",
+    "itemName": "Specify the name of the property that provides the collection 
+                 of pageable items. It is optional. Default value is 'value'." 
   }
 }
 ```
@@ -616,4 +618,4 @@ If an operation requires that a parameter is exposed as a method parameter, it i
 
 TODO: naming standards for operations Create, CreateOrUpdate, Update (respect etag), Get, List, Delete, Patch
 TODO: patch => no validate
-[Swagger-spec2.0]:https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md
+[Swagger-spec2.0]:https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md
