Bias Analysis
Detected Bias Types
windows_first
windows_tools
missing_linux_example
powershell_heavy
Summary
The documentation exhibits several signs of Windows bias: file paths are shown in Windows format (e.g., C:\templates\main.bicep) without Linux/macOS equivalents, PowerShell examples and references are prevalent and often shown first, and there is no mention of Linux/macOS-specific considerations (such as file path differences or shell syntax). The documentation assumes the use of Windows tools and patterns, which may create friction for Linux/macOS users.
Recommendations
- Provide Linux/macOS file path examples (e.g., ~/templates/main.bicep) alongside Windows paths.
- Explicitly mention that Azure CLI commands work cross-platform and clarify any differences in shell syntax (e.g., variable assignment, path separators).
- Add notes or tabs for Linux/macOS users where PowerShell is referenced, suggesting Bash or other native shells.
- Ensure all instructions (especially for file creation and command usage) are platform-agnostic or include platform-specific guidance.
- Reference documentation for Azure CLI installation on Linux/macOS, not just Windows.
- Avoid assuming the use of Windows tools or patterns in general instructions.
Create Pull Request