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:
⚠️ windows_first
⚠️ powershell_heavy
⚠️ windows_tools
Summary:
The documentation provides both Azure CLI and Azure PowerShell examples for all operations, but PowerShell is given equal prominence to CLI, and the 'Next steps' section exclusively promotes a PowerShell-based tutorial. PowerShell is a Windows-centric tool, and there is no mention of Linux-specific considerations or examples (e.g., Bash scripting, Linux shell nuances), nor is there any guidance for Mac/Linux users. The documentation implicitly assumes familiarity with Windows/PowerShell environments.
Recommendations:
  • In the 'Next steps' section, offer both CLI-based and PowerShell-based tutorials, or default to CLI (which is cross-platform) to avoid Windows bias.
  • Explicitly mention that Azure CLI commands work on Windows, Linux, and macOS, and consider including Bash script examples or notes for Linux/Mac users.
  • Clarify that PowerShell Core is cross-platform, but note that many users on Linux/macOS may prefer CLI or Bash.
  • Add a brief section or note for Linux/macOS users, highlighting any differences or confirming that the steps are fully supported on those platforms.
  • Ensure that CLI examples are presented first, as it is the most universally accessible tool, and consider de-emphasizing PowerShell unless there is a Windows-specific audience.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-09-10 00:00 #107 completed ✅ Clean
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ✅ Clean
2025-07-12 23:44 #41 in_progress ❌ Biased

Flagged Code Snippets

# [PowerShell](#tab/PowerShell)
New-AzResourceGroup -Name exampleRG -Location eastus New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -roleDefinitionID "9980e02c-c2be-4d73-94e8-173b1dc7cf3c" -principalId "<principal-id>"
# [PowerShell](#tab/PowerShell)