Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates a Windows bias by presenting PowerShell examples before Azure CLI examples, using Windows-style file paths in PowerShell commands, and referencing Windows-specific tools (PowerShell) without equal emphasis on Linux-native equivalents. The PowerShell section appears first, and the file path syntax (e.g., c:\MyTemplates\azuredeploy.json) is Windows-specific, which may confuse Linux users. There are no Bash or Linux shell examples, nor are there notes about cross-platform usage for PowerShell or CLI.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present CLI examples first to avoid implicit prioritization of Windows tools.
- Include Linux/Bash shell examples, especially for Azure CLI usage, with Linux-style file paths (e.g., /home/user/MyTemplates/azuredeploy.json).
- Add notes clarifying that PowerShell is available cross-platform, and provide instructions or examples for using PowerShell on Linux/macOS.
- Where file paths are shown, provide both Windows and Linux path formats.
- Explicitly mention cross-platform compatibility for all tools and commands, and link to installation guides for Linux users.
Create Pull Request