Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by consistently presenting PowerShell (a Windows-centric tool) before CLI examples, referencing Windows tools such as Visual Studio Code and Git Bash for Bash shells, and omitting native Linux shell examples. The instructions and tooling recommendations are oriented toward Windows users, with Linux alternatives mentioned only as secondary options or not at all.
Recommendations
- Present CLI (az) examples before or alongside PowerShell examples to avoid implying Windows is the primary platform.
- Explicitly mention native Linux shells (e.g., Ubuntu Bash, macOS Terminal) in the prerequisites and instructions, not just Git Bash (which is a Windows workaround).
- Add guidance for running commands in Linux/macOS environments, including installation steps for Azure CLI on those platforms.
- Avoid language that assumes Visual Studio Code or PowerShell as the default environment; suggest cross-platform editors and shells.
- Ensure all code samples use platform-agnostic paths and syntax (e.g., forward slashes for file paths, environment variable usage) or provide platform-specific notes where necessary.
Create Pull Request