Skip to content

Commit fa91c9d

Browse files
committed
Update md file metadata
1 parent 73e1f92 commit fa91c9d

132 files changed

Lines changed: 536 additions & 414 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
1-
---
1+
---
22
title: Learn best practices when developing Bicep files
33
description: Describes practices to follow when creating your Bicep files so they work well and are easy to maintain.
44
author: johndowns
55
ms.author: jodowns
6-
ms.topic: conceptual
6+
ms.topic: article
77
ms.custom: devx-track-bicep
88
ms.date: 10/30/2025
99
---
@@ -119,3 +119,4 @@ You can't create policies or role assignments at the [tenant scope](deploy-to-te
119119

120120
* For an introduction to Bicep, see [Bicep quickstart](quickstart-create-bicep-use-visual-studio-code.md).
121121
* For information about the parts of a Bicep file, see [Understand the structure and syntax of Bicep files](file.md).
122+

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
---
1+
---
22
title: Linter settings for Bicep config
33
description: Describes how to customize configuration values for the Bicep linter
4-
ms.topic: conceptual
4+
ms.topic: article
55
ms.custom: devx-track-bicep
66
ms.date: 06/19/2025
77
---
@@ -212,3 +212,4 @@ For the rule about hardcoded environment URLs, you can customize which URLs are
212212
- [Configure your Bicep environment](bicep-config.md)
213213
- [Add module settings in Bicep config](bicep-config-modules.md)
214214
- Learn about the [Bicep linter](linter.md)
215+

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
---
1+
---
22
title: Module setting for Bicep config
33
description: Describes how to customize configuration values for modules in Bicep deployments.
4-
ms.topic: conceptual
4+
ms.topic: article
55
ms.custom: devx-track-bicep
66
ms.date: 04/28/2025
77
---
@@ -177,3 +177,4 @@ Bicep uses the [Azure.Identity SDK](/dotnet/api/azure.identity) to do authentica
177177
- [Configure your Bicep environment](bicep-config.md)
178178
- [Add linter settings to Bicep config](bicep-config-linter.md)
179179
- Learn about [modules](modules.md)
180+

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
---
1+
---
22
title: Configure your Bicep environment
33
description: Learn how to configure your environment for Bicep file deployments.
4-
ms.topic: conceptual
4+
ms.topic: article
55
ms.date: 10/30/2025
66
ms.custom: devx-track-bicep
77
---
@@ -152,3 +152,4 @@ See [Experimental Features](https://aka.ms/bicep/experimental-features) for more
152152

153153
- Learn how to add [module settings](bicep-config-modules.md) and [linter settings](bicep-config-linter.md) in the Bicep config file.
154154
- Learn about the [Bicep linter](linter.md).
155+

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
---
1+
---
22
title: Use extensions in Bicep
33
description: This article describes how to use Bicep extensions.
4-
ms.topic: conceptual
4+
ms.topic: article
55
ms.custom:
66
- devx-track-bicep
77
- build-2025
@@ -35,3 +35,4 @@ For examples, see [Bicep Kubernetes extension](./bicep-kubernetes-extension.md)
3535
- To learn how to use the Bicep Kubernetes extension, see [Bicep Kubernetes extension](./bicep-kubernetes-extension.md).
3636
- To go through a Kubernetes extension tutorial, see [Quickstart: Deploy Azure applications to Azure Kubernetes Services by using the Bicep Kubernetes extension](/azure/aks/learn/quick-kubernetes-deploy-bicep-kubernetes-extension).
3737
- To learn Microsoft Graph extension, see [Microsoft Graph extension](https://aka.ms/graphbicep).
38+

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
---
1+
---
22
title: Imports in Bicep
33
description: This article describes how to import shared functionality and namespaces in Bicep.
4-
ms.topic: conceptual
4+
ms.topic: article
55
ms.custom:
66
- devx-track-bicep
77
- build-2025
@@ -102,3 +102,4 @@ Both `az` and `sys` are Bicep built-in namespaces. They're imported by default.
102102
- To learn about how to use the Kubernetes extension, see [Bicep Kubernetes extension](./bicep-kubernetes-extension.md).
103103
- To go through a Kubernetes extension tutorial, see [Quickstart - Deploy Azure applications to Azure Kubernetes Services by using Bicep Kubernetes extension.](/azure/aks/learn/quick-kubernetes-deploy-bicep-kubernetes-extension).
104104
- To learn about how to use the Microsoft Graph extension, see [Bicep files for Microsoft Graph](https://aka.ms/graphbicep).
105+

articles/azure-resource-manager/bicep/bicep-kubernetes-extension.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
---
1+
---
22
title: Bicep Kubernetes extension
33
description: Learn how to Bicep Kubernetes extension to deploy .NET applications to Azure Kubernetes Service clusters.
4-
ms.topic: conceptual
4+
ms.topic: article
55
ms.custom:
66
- devx-track-bicep
77
- devx-track-dotnet
@@ -85,3 +85,4 @@ From Visual Studio Code, you can import Kubernetes manifest files to create Bice
8585

8686
- To walk through a quickstart, see [Quickstart - Deploy Azure applications to Azure Kubernetes Services by using Bicep Kubernetes extension](/azure/aks/learn/quick-kubernetes-deploy-bicep-kubernetes-extension).
8787
- To learn about how to use the Microsoft Graph extension, see [Bicep files for Microsoft Graph](https://aka.ms/graphbicep).
88+

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

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
---
1+
---
22
title: Using and using none statements
33
description: Learn how to use the `using` and `using none` statements in Bicep.
4-
ms.topic: conceptual
4+
ms.topic: article
55
ms.date: 06/30/2025
66
ms.custom: devx-track-bicep
77
---
@@ -10,9 +10,9 @@ ms.custom: devx-track-bicep
1010

1111
A `using` or a `using none` declaration must be present in all Bicep parameters files.
1212

13-
A Bicep parameter file typically uses a `using` statement to tie the file to a [Bicep file](./file.md), a [JSON Azure Resource Manager template (ARM template)](../templates/syntax.md), a [Bicep module](./modules.md), or a [template spec](./template-specs.md). This linkage allows the Bicep language server and compiler to validate the parameter file—checking for correct names, types, and required values based on the template’s inputs.
13+
A Bicep parameter file typically uses a `using` statement to tie the file to a [Bicep file](./file.md), a [JSON Azure Resource Manager template (ARM template)](../templates/syntax.md), a [Bicep module](./modules.md), or a [template spec](./template-specs.md). This linkage allows the Bicep language server and compiler to validate the parameter file—checking for correct names, types, and required values based on the template’s inputs.
1414

15-
In contrast, the `using none` statement explicitly indicates that the parameter file isn't tied to any particular template at compile time. This means the parameters aren't validated against a specific template and are instead intended for more general use—such as being consumed by external tools or serving as shared, reusable parameter sets.
15+
In contrast, the `using none` statement explicitly indicates that the parameter file isn't tied to any particular template at compile time. This means the parameters aren't validated against a specific template and are instead intended for more general use—such as being consumed by external tools or serving as shared, reusable parameter sets.
1616

1717
> [!NOTE]
1818
> Bicep parameters files are supported only in [Bicep CLI version 0.18.4](https://github.com/Azure/bicep/releases/tag/v0.18.4) or later, [Azure CLI](/cli/azure/install-azure-cli) version 2.47.0 or later, and [Azure PowerShell](/powershell/azure/install-azure-powershell) version 9.7.1 or later. The `using none` feature is supported in [Bicep CLI version 0.31.0](https://github.com/Azure/bicep/releases/tag/v0.31.92) or later.
@@ -113,7 +113,7 @@ The primary benefit of `using none` in Bicep lies in scenarios where parameter f
113113

114114
- **Centralized Parameter Repositories**
115115

116-
Organizations often maintain standard parameter values—such as default regions, naming conventions, or global tags—used across multiple Bicep deployments. A Bicep parameters file with using none can act as a central store for these shared values, improving consistency and minimizing duplication. These parameters can then be programmatically merged with template-specific values at deployment time.
116+
Organizations often maintain standard parameter values—such as default regions, naming conventions, or global tags—used across multiple Bicep deployments. A Bicep parameters file with using none can act as a central store for these shared values, improving consistency and minimizing duplication. These parameters can then be programmatically merged with template-specific values at deployment time.
117117

118118
For example, a shared Bicep parameters file might define:
119119

@@ -129,9 +129,10 @@ The primary benefit of `using none` in Bicep lies in scenarios where parameter f
129129

130130
In CI/CD pipelines or automation scripts, parameter files may be created on-the-fly or associated with templates at runtime. By omitting a fixed template reference, `using none` allows these files to remain flexible and adaptable to different deployment contexts.
131131

132-
When `using none` is specified in a Bicep parameter file, the compiler doesn't validate the parameters against a specific Bicep template, meaning no compile-time warnings or errors are raised for mismatched names or types due to the absence of a linked template. However, this decoupling applies only during authoring and compilation—at deployment time, Azure Resource Manager (ARM) still requires both a Bicep template and a parameter file. The ARM engine performs validation during deployment by resolving the parameters in the file against those defined in the target template.
132+
When `using none` is specified in a Bicep parameter file, the compiler doesn't validate the parameters against a specific Bicep template, meaning no compile-time warnings or errors are raised for mismatched names or types due to the absence of a linked template. However, this decoupling applies only during authoring and compilation—at deployment time, Azure Resource Manager (ARM) still requires both a Bicep template and a parameter file. The ARM engine performs validation during deployment by resolving the parameters in the file against those defined in the target template.
133133

134134
## Next steps
135135

136136
- Learn about Bicep parameters files in [Create parameters files for Bicep deployment](./parameter-files.md).
137137
- Learn about configuring aliases in _bicepconfig.json_ files in [Configure your Bicep environment](./bicep-config.md).
138+

articles/azure-resource-manager/bicep/child-resource-name-type.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
---
1+
---
22
title: Child resources in Bicep
33
description: Describes how to set the name and type for child resources in Bicep.
4-
ms.topic: conceptual
4+
ms.topic: article
55
ms.custom: devx-track-bicep
66
ms.date: 04/28/2025
77
---
@@ -177,3 +177,4 @@ resource share 'Microsoft.Storage/storageAccounts/fileServices/shares@2025-06-01
177177

178178
* To learn about creating Bicep files, see [Understand the structure and syntax of Bicep files](./file.md).
179179
* To learn about the format of the resource name when referencing the resource, see the [reference function](./bicep-functions-resource.md#reference).
180+

articles/azure-resource-manager/bicep/compare-template-syntax.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
---
1+
---
22
title: Compare syntax for Azure Resource Manager templates in JSON and Bicep
33
description: Compares Azure Resource Manager templates developed with JSON and Bicep, and shows how to convert between the languages.
4-
ms.topic: conceptual
4+
ms.topic: article
55
ms.custom: devx-track-bicep, devx-track-arm-template
66
ms.date: 04/28/2025
77
---
@@ -325,3 +325,4 @@ To separate a solution into multiple files:
325325

326326
* For information about the Bicep, see [Bicep quickstart](./quickstart-create-bicep-use-visual-studio-code.md).
327327
* To learn about converting templates between the languages, see [Converting ARM templates between JSON and Bicep](decompile.md).
328+

0 commit comments

Comments
 (0)