Merge pull request #216771 from mumian/1101-decompiler-cleanup

New linter rule for decompiler cleanup

Author: 19BMG00

articles/azure-resource-manager/bicep/bicep-config-linter.md

@@ -2,7 +2,7 @@
 title: Linter settings for Bicep config
 description: Describes how to customize configuration values for the Bicep linter
 ms.topic: conceptual
-ms.date: 09/30/2022
+ms.date: 11/01/2022
 ---
 
 # Add linter settings in the Bicep config file
@@ -29,6 +29,9 @@ The following example shows the rules that are available for configuration.
         "artifacts-parameters": {
           "level": "warning"
         },
+        "decompiler-cleanup": {
+          "level": "warning"
+        },
         "max-outputs": {
           "level": "warning"
         },

articles/azure-resource-manager/bicep/linter-rule-decompiler-cleanup.md

@@ -0,0 +1,24 @@
+---
+title: Linter rule - decompiler cleanup
+description: Linter rule - decompiler cleanup
+ms.topic: conceptual
+ms.date: 11/01/2022
+---
+
+# Linter rule - decompiler cleanup
+
+The [Bicep CLI decompile](./bicep-cli.md#decompile) command converts ARM template JSON to a Bicep file. If a variable name, or a parameter name, or a resource symbolic name is ambiguous, the Bicep CLI adds a suffix to the name, for example *accountName_var* or *virtualNetwork_resource*. This rule finds these names in Bicep files.
+
+## Linter rule code
+
+Use the following value in the [Bicep configuration file](bicep-config-linter.md) to customize rule settings:
+
+`decompiler-cleanup`
+
+## Solution
+
+To increase the readability, update these names with more meaningful names.
+
+## Next steps
+
+For more information about the linter, see [Use Bicep linter](./linter.md).

articles/azure-resource-manager/bicep/linter.md

@@ -2,7 +2,7 @@
 title: Use Bicep linter
 description: Learn how to use Bicep linter.
 ms.topic: conceptual
-ms.date: 9/30/2022
+ms.date: 11/01/2022
 ---
 
 # Use Bicep linter
@@ -19,6 +19,7 @@ The default set of linter rules is minimal and taken from [arm-ttk test cases](.
 
 - [adminusername-should-not-be-literal](./linter-rule-admin-username-should-not-be-literal.md)
 - [artifacts-parameters](./linter-rule-artifacts-parameters.md)
+- [decompiler-cleanup](./linter-rule-decompiler-cleanup.md)
 - [max-outputs](./linter-rule-max-outputs.md)
 - [max-params](./linter-rule-max-parameters.md)
 - [max-resources](./linter-rule-max-resources.md)

articles/azure-resource-manager/bicep/toc.yml

@@ -392,6 +392,8 @@
         href: linter-rule-admin-username-should-not-be-literal.md
       - name: Artifacts parameters
         href: linter-rule-artifacts-parameters.md
+      - name: Decompiler cleanup
+        href: linter-rule-decompiler-cleanup.md
       - name: Max outputs
         href: linter-rule-max-outputs.md
       - name: Max parameters