Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation demonstrates a significant Windows bias. PowerShell and Windows-specific command prompts are used exclusively in all CLI and PowerShell examples, with explicit references to 'Windows PowerShell' and output paths like 'PS C:\Windows>'. There are no Linux or macOS terminal examples, nor are there instructions or screenshots for non-Windows environments. Even when discussing Azure CLI, which is cross-platform, the examples and instructions are framed in a Windows context, and MSI installers (Windows-specific) are mentioned before cross-platform alternatives. No Bash or Linux-native shell usage is shown, and Linux installation or usage patterns are not addressed.
Recommendations
- Provide parallel examples for Linux/macOS users, using Bash or sh terminals (e.g., $ az login) alongside Windows PowerShell examples.
- Include instructions for installing Azure CLI on Linux and macOS, not just via MSI for Windows.
- Show sample outputs from Linux/macOS terminals (e.g., /home/user>), not just Windows paths.
- Explicitly state that Azure CLI commands work identically on Linux/macOS and provide any OS-specific caveats.
- Avoid language like 'Open up a Windows PowerShell command window' when the tool is cross-platform; instead, use neutral phrasing such as 'Open your terminal.'
- Add screenshots or references for Linux/macOS environments where appropriate.
- Ensure that all steps and troubleshooting sections mention Linux/macOS where differences exist.
Create Pull Request