Skip to content

Commit db0b76a

Browse files
committed
On branch edburns-msft-96155-jsonc-mention Apply comments from @alex-frankel. Thanks.
modified: articles/azure-resource-manager/templates/best-practices.md modified: articles/azure-resource-manager/templates/deploy-cli.md Signed-off-by: Ed Burns <[email protected]>
1 parent 1a3b312 commit db0b76a

File tree

2 files changed

+6
-2
lines changed

2 files changed

+6
-2
lines changed

articles/azure-resource-manager/templates/best-practices.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -291,7 +291,11 @@ The following information can be helpful when you work with [resources](./syntax
291291

292292
## Comments
293293

294-
In addition to the `comments` property, if your ARM template is stored in a `.jsonc` file, comments using the `//` syntax are supported. For more details about comments and metadata see [Understand the structure and syntax of ARM templates](/azure/azure-resource-manager/templates/syntax#comments-and-metadata).
294+
In addition to the `comments` property, comments using the `//` syntax are supported. For more details about comments and metadata see [Understand the structure and syntax of ARM templates](/azure/azure-resource-manager/templates/syntax#comments-and-metadata). You may choose to save JSON files that contain `//` comments using the `.jsonc` file extension, to indicate the JSON file contains comments. The ARM service will also accept comments in any JSON file including parameters files.
295+
296+
## Visual Studio Code Azure Resource Manager Tools
297+
298+
Working with ARM templates is much easier with the Azure Resource Manager (ARM) Tools for Visual Studio Code. This extension provides language support, resource snippets, and resource auto-completion to help you create and validate Azure Resource Manager templates. To learn more and install the extension, see (Azure Resource Manager (ARM) Tools)[https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools].
295299

296300
## Use test toolkit
297301

articles/azure-resource-manager/templates/deploy-cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ az deployment group create \
7979
--parameters storageAccountType=Standard_GRS
8080
```
8181

82-
The value of the `--template-file` parameter must be a Bicep file or a `.json` or `.jsonc` file. The `.jsonc` file extension indicates the file can contain `//` style comments. For more details about comments and metadata see [Understand the structure and syntax of ARM templates](/azure/azure-resource-manager/templates/syntax#comments-and-metadata).
82+
The value of the `--template-file` parameter must be a Bicep file or a `.json` or `.jsonc` file. The `.jsonc` file extension indicates the file can contain `//` style comments. The ARM system accepts `//` comments in `.json` files. It does not care about the file extension. For more details about comments and metadata see [Understand the structure and syntax of ARM templates](/azure/azure-resource-manager/templates/syntax#comments-and-metadata).
8383

8484
The Azure deployment template can take a few minutes to complete. When it finishes, you see a message that includes the result:
8585

0 commit comments

Comments
 (0)