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
⚠️ missing_linux_example
Summary:
The documentation consistently presents PowerShell (a Windows-centric tool) examples before Azure CLI, and the PowerShell examples use Windows file paths (e.g., c:\Templates\azuredeploy.json) without offering Linux/macOS equivalents. There is no explicit mention or example for Linux/macOS users regarding file paths or shell differences, and the CLI section only briefly notes that Bash syntax may differ in other environments without providing concrete Linux/macOS alternatives.
Recommendations:
  • Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first to avoid implicit Windows prioritization.
  • For file paths, provide both Windows (e.g., c:\Templates\azuredeploy.json) and Linux/macOS (e.g., ~/Templates/azuredeploy.json) examples in relevant commands.
  • Explicitly mention and provide examples for Linux/macOS users, especially where shell syntax or environment variables differ (e.g., use $HOME or ~/ for paths, note differences in date command usage).
  • Clarify in the introductory text that both Windows and Linux/macOS are supported, and link to platform-specific guidance if available.
  • Where PowerShell is referenced, clarify that PowerShell Core is cross-platform, or provide Bash/zsh alternatives for Linux/macOS users.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-19 00:01 #85 completed ❌ Biased
2025-07-19 13:51 #54 completed ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased

Flagged Code Snippets