Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits a moderate Windows bias. PowerShell examples are consistently presented before Azure CLI examples, and the documentation refers to Windows-specific tools and environment variables (e.g., %USERPROFILE%). There is a lack of parity in some explanations, such as more detailed Windows path examples compared to Linux. No Linux shell (bash) or scripting examples are provided, and the overall structure assumes familiarity with Windows conventions.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI (cross-platform) examples first to avoid implicit prioritization of Windows.
- Provide bash shell scripting examples alongside PowerShell, especially for automation scenarios.
- Ensure that all path examples are equally detailed for Windows, Linux, and Mac, and use environment variables that are platform-appropriate (e.g., $HOME for Linux/Mac).
- Explicitly state that Azure CLI commands work identically on Windows, Linux, and Mac, and provide any necessary platform-specific notes.
- Where possible, avoid referencing Windows-specific tools or patterns exclusively; mention cross-platform alternatives.
- Include a section or callout for Linux users, highlighting any differences or additional steps required.
Create Pull Request