Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates a mild Windows bias. Azure PowerShell is presented as a primary tool alongside Azure CLI, and installation instructions for Azure CLI list Windows before Linux and macOS. The editor recommendation is Visual Studio Code, a Microsoft product popular on Windows. The tutorial does provide Bash-based CLI examples and mentions Linux installation, but Windows-centric tools and patterns (PowerShell, VS Code) are emphasized or listed first.
Recommendations
- List installation instructions for Azure CLI in a neutral or alphabetical order (e.g., Linux, macOS, Windows) rather than Windows first.
- Explicitly mention that both Azure PowerShell and Azure CLI are cross-platform, and clarify which is recommended for Linux users.
- Include alternative editor suggestions (e.g., Vim, Nano, Sublime Text) for Linux users alongside Visual Studio Code.
- Add a note or section highlighting Linux-specific considerations, such as file permissions or shell differences, if relevant.
- Ensure that examples and instructions are equally accessible and tested on Linux, and avoid implying that Windows tools are the default.
Create Pull Request