Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a bias toward Windows by primarily featuring PowerShell commands and examples, referencing Windows-based virtual machines before Linux-based ones, and omitting equivalent Linux/macOS CLI or Bash examples in key sections. The migration instructions and next steps also prioritize PowerShell, with CLI guidance mentioned only after PowerShell and not integrated into examples. This creates friction for Linux/macOS users who may prefer Bash, Azure CLI, or other non-Windows tools.
Recommendations
- Provide Azure CLI and Bash examples alongside PowerShell commands, especially in sections demonstrating resource queries and migrations.
- Reference Linux-based virtual machines equally and provide examples for SSH connectivity and Linux management tasks.
- Ensure links and next steps include both PowerShell and CLI/Bash documentation, and avoid presenting Windows tools or workflows first unless contextually necessary.
- Add explicit notes or tables comparing command-line options for Windows, Linux, and macOS users.
Create Pull Request