Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in several ways. Windows tools and patterns (PowerShell, Windows paths, screenshots) are presented first or exclusively. The installation instructions list Windows before Linux and macOS. PowerShell is given equal or greater prominence to Azure CLI, and CLI examples are written for Bash but include notes about adapting for Windows, with no equivalent notes for Linux users. There are no Linux-specific screenshots or workflow guidance, and the editor instructions use Windows-centric terminology (e.g., 'workstation', Visual Studio Code screenshots from Windows).
Recommendations
- Present Azure CLI examples before PowerShell, as CLI is cross-platform and more commonly used on Linux.
- Include Linux-specific notes and screenshots, such as file path conventions and terminal environments.
- Add explicit instructions for running CLI commands in Linux shells (e.g., bash, zsh), including handling file paths and environment variables.
- Balance installation instructions by listing Linux and macOS before or alongside Windows, or group them together neutrally.
- Use neutral terminology (e.g., 'computer' or 'machine' instead of 'workstation') and avoid Windows-centric language.
- Provide equivalent adaptation notes for Linux users when discussing command-line syntax differences.
- Include screenshots of Visual Studio Code on Linux or macOS, or use generic editor screenshots.
Create Pull Request