Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is presented first in all major sections, with detailed scripting examples. The Azure CLI section provides both Bash and Windows command syntax, but Windows batch syntax is given equal prominence to Bash, and Windows-specific commands (e.g., REM for comments, set for variables) are included. There is no explicit Linux example or mention of Linux-specific considerations, and the documentation assumes familiarity with Windows tools and patterns throughout.
Recommendations
- Alternate the order of PowerShell and Azure CLI sections, or present Azure CLI first to balance platform representation.
- In CLI examples, prioritize Bash syntax and provide Windows batch syntax as a secondary note, since Bash is more common on Linux and macOS.
- Explicitly mention Linux and macOS compatibility for Azure CLI, and provide troubleshooting notes or tips for those platforms if needed.
- Add a note clarifying that PowerShell Core is available cross-platform, and provide examples for running PowerShell scripts on Linux/macOS.
- Include links to installation guides for Azure CLI and PowerShell on Linux and macOS, not just Windows.
- Review terminology to avoid Windows-centric language (e.g., avoid assuming 'set' and 'REM' are familiar to all users).
Create Pull Request