Fixed a bunch of README files.

100-starter-template-with-validation/README.md

@@ -1,3 +1,5 @@
 # Starter template with validation
 
-This is a starter template that will pass the validation checks. Please read the contributing guide to learn more about what's required for successfully passing validation checks when the indexing process to Azure.com begins.
+This is a starter template that will pass the validation checks. Please read the contributing guide to learn more about what's required for successfully passing validation checks. 
+
+In this example, the template deploys a basic Availability Set resource. This is just a snippet you may want to include in a more complex template.

100-starter-template-with-validation/azuredeploy.json

@@ -5,7 +5,7 @@
     "availabilitySetName": {
       "type": "String",
       "metadata": {
-        "Description": "This is the name of the Availability Set"
+        "Description": "This is the name of the sample Availability Set"
       }
     },
     "location": {

101-create-availability-set-3FDs/README.md

@@ -4,4 +4,5 @@ Create Availability Set  - <a href="https://azuredeploy.net" target="_blank">
     <img src="http://azuredeploy.net/deploybutton.png"/>
 </a>
 
-Creates an Availability Set and configures it for 3 Fault Domains.
+This template creates an Availability Set and configures it for 3 Fault Domains. This is just a snippet you may want to include in a more complex template 3 FDs are very useful when you're building a quorum-based solution or simply to ensure high availability of your service.
+

101-create-availability-set-3FDs/azuredeploy.json

@@ -5,21 +5,21 @@
     "availabilitySetName": {
       "type": "String",
 	    "metadata": {
-		    "Description": "Name of Availability Set"
+		    "description": "Name of Availability Set"
 		  }
     },
     "location": {
       "type": "String",
       "allowedValues": ["East US", "West US", "West Europe", "East Asia", "South East Asia"],
 	    "metadata": {
-        "Description": "Location to deploy to"
+        "description": "Location to deploy to"
       }
     },
     "faultDomainCount":{
       "type":"String",
       "defaultValue":"3",
 	    "metadata": {
-        "Description": "Count of Fault Domains"
+        "description": "Count of Fault Domains"
       }
     }
   },
@@ -30,7 +30,7 @@
       "apiVersion": "2015-05-01-preview",
       "location": "[parameters('location')]",
       "properties": {
-        "PlatformFaultDomainCount":"[parameters('faultDomainCount')]"
+        "platformFaultDomainCount":"[parameters('faultDomainCount')]"
       }
     }
   ]

101-create-availability-set/README.md

@@ -3,3 +3,5 @@
 Create Availability Set  - <a href="https://azuredeploy.net" target="_blank">
     <img src="http://azuredeploy.net/deploybutton.png"/>
 </a>
+
+This template deploys an Availability Set to a specified location. This is just a snippet you may want to include in a more complex template.