About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation provides both Azure CLI and Azure PowerShell instructions for deploying Bicep files, but the inclusion of Azure PowerShell (which is primarily a Windows-centric tool) alongside Azure CLI (which is cross-platform) introduces a Windows bias. PowerShell examples are given equal prominence to CLI, and the documentation refers to 'Azure PowerShell' as a primary deployment method, which may not be as relevant for Linux users. There are no Linux-specific shell (bash) examples or explicit mention of Linux environments, and PowerShell is presented as a first-class option rather than as an alternative for Windows users.
Recommendations:
- Clearly indicate that Azure CLI is cross-platform and preferred for Linux/macOS users, while Azure PowerShell is primarily for Windows.
- Add bash/zsh shell examples for common Linux workflows, especially for validation and cleanup steps.
- If PowerShell is included, clarify its cross-platform availability but note its prevalence on Windows.
- Consider reordering sections to present Azure CLI (or bash) before PowerShell, or group PowerShell as a Windows-specific alternative.
- Explicitly mention Linux/macOS compatibility in the prerequisites and throughout the instructions.
Create pull request
Flagged Code Snippets
az group create --name exampleRG --location <SUPPORTED_REGION>
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters functionAppRuntime=powerShell functionAppRuntimeVersion=7.4
New-AzResourceGroup -Name exampleRG -Location <SUPPORTED_REGION>
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -functionAppRuntime "dotnet-isolated" -functionAppRuntimeVersion "8.0"
### [Azure PowerShell](#tab/azure-powershell)
New-AzResourceGroup -Name exampleRG -Location <SUPPORTED_REGION>
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -functionAppRuntime "dotnet-isolated" -functionAppRuntimeVersion "8.0"