Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Windows tools and patterns (PowerShell, Windows paths, screenshots) are presented either exclusively or before their Linux equivalents. PowerShell is given equal or greater prominence than Azure CLI, and CLI examples are written for Bash but with notes about adapting for Windows. Installation instructions list Windows first, and there are no explicit Linux-specific workflow examples (e.g., using Linux editors, shell environments, or file paths). Screenshots and instructions assume a Windows-style environment, with no mention of Linux desktop equivalents.
Recommendations
- Ensure installation instructions for Azure CLI list Linux and macOS before or alongside Windows, not after.
- Provide explicit Linux workflow examples, including using Linux-native editors (e.g., Vim, nano, gedit) and Linux file paths.
- Include screenshots from Linux environments (e.g., Ubuntu desktop, GNOME Terminal) alongside Windows screenshots.
- Clarify that Visual Studio Code is cross-platform and mention alternatives for Linux users.
- Add notes or tabs for running Azure CLI commands in Linux shells (e.g., zsh, fish) and explain any differences in environment variables or file paths.
- Avoid assuming Windows-style file paths and explain how to adapt instructions for Linux/macOS file systems.
- Balance PowerShell and CLI coverage, and consider highlighting Azure CLI as the default for cross-platform scenarios.
Create Pull Request