Use Comments

All parameters and resources should have comments associated with them. Comments help in understanding their purpose and usage. The purpose and the usage of the parameter and the resource should be easily understood by anyone reading the ARM template code. Comments in ARM templates are provided by means of the metadata element.

Both the primaryServiceBusNamespaceName and primaryServiceBusSku parameters have an addition metadata element. This element helps in adding comments within ARM templates:

  "parameters": {
    "primaryServiceBusNamespaceName": {
      "type": "string",
      "metadata": {
        "description": "Service Bus namespace name"
      }
    },

    "primaryServiceBusSku": {
      "type": "string",
      "metadata": {
        "description"...