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 deployment instructions using both Azure CLI and Azure PowerShell. While Azure CLI is cross-platform, Azure PowerShell is primarily a Windows-centric tool, and its inclusion as a first-class alternative (with full code samples for every language) indicates a Windows bias. There are no Linux-specific shell examples (e.g., Bash), and the PowerShell examples are given equal prominence to the CLI, which may confuse or disadvantage Linux users. Additionally, the documentation refers to saving files to your 'local computer' without clarifying cross-platform paths or shell conventions.
Recommendations:
- Add explicit Bash shell examples for Linux/macOS users alongside Azure CLI commands, including file path conventions (e.g., ./main.bicep).
- Clarify that Azure CLI commands work identically on Windows, Linux, and macOS, and recommend it as the primary cross-platform tool.
- De-emphasize Azure PowerShell as a primary deployment method, or clearly label it as Windows-centric, with a note for Linux users about PowerShell Core availability.
- Include notes or examples for common Linux/macOS shell environments where relevant (e.g., using export for environment variables, file permissions, etc.).
- Ensure that any references to file paths or shell commands use cross-platform syntax or provide both Windows and Linux/macOS variants.
Create pull request
Flagged Code Snippets
New-AzResourceGroup -Name exampleRG -Location <SUPPORTED_REGION>
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -functionAppRuntime "dotnet-isolated" -functionAppRuntimeVersion "8.0"
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 "java" -functionAppRuntimeVersion "17"
New-AzResourceGroup -Name exampleRG -Location <SUPPORTED_REGION>
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -functionAppRuntime "node" -functionAppRuntimeVersion "20"
### [Azure PowerShell](#tab/azure-powershell)