Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation exhibits a moderate Windows bias. In several places, Windows-centric tools (PowerShell) are mentioned before cross-platform alternatives (Azure CLI), and instructions reference Windows PowerShell as the default console application. The PowerShell examples are detailed and prominent, and there is an assumption that users are familiar with Windows tooling. There are no explicit Linux shell examples (e.g., bash), nor is there guidance for Linux-specific environments or shell usage. The Azure CLI instructions do not clarify Linux usage, and the mention of 'Windows PowerShell' as the console application for CLI is misleading for Linux users.
Recommendations
- Add explicit instructions and examples for Linux/macOS users, including using bash/zsh terminals.
- When referencing Azure CLI, clarify that it runs on Windows, Linux, and macOS, and provide example commands in bash syntax (e.g., export variables, use $HOME).
- Avoid referring to 'Windows PowerShell' as the default console for CLI; instead, use 'command-line terminal' or mention alternatives.
- Present cross-platform tools (Azure CLI, ARM templates) before or alongside Windows-specific tools (PowerShell) to avoid Windows-first ordering.
- Include notes or callouts for Linux users regarding authentication, environment setup, and command syntax differences.
Create Pull Request