This page contains Windows bias

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.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

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"