Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell examples and references (e.g., New-AzVM, Get-AzComputeResourceSku) are given equal or greater prominence compared to Azure CLI, and Windows-centric tools and patterns (PowerShell scripting, Windows path notation) are used in examples. The REST example uses a Windows-style path ('.\sku-list.json') for output, and PowerShell is featured with detailed scripts, while Linux shell scripting or Bash alternatives are not provided. There is no explicit Linux example or mention of Linux-specific tooling, and Windows/PowerShell commands are often presented before or alongside CLI commands, rather than after or as alternatives.
Recommendations
- Add Bash/Linux shell script examples for filtering and processing Azure CLI output, especially where PowerShell scripts are provided.
- Use platform-neutral path notation (e.g., './sku-list.json') in CLI examples to avoid Windows bias.
- Explicitly mention that Azure CLI commands work cross-platform and provide sample usage in Bash or other Linux shells.
- Where PowerShell scripts are shown, offer equivalent Bash/awk/jq pipelines for Linux users.
- Ensure that CLI examples are presented before or alongside PowerShell examples, and clarify platform compatibility for each command.
Create Pull Request