Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias, particularly in the section describing how to install and use the Azure CLI. It instructs users to install Az CLI and then explicitly says 'open PowerShell on your system as an Administrator' and provides only PowerShell-based instructions for running CLI commands. There are no Linux/macOS terminal examples, nor is it mentioned that Az CLI can be used on Bash or other shells. The overall flow and screenshots are platform-neutral (Azure Portal), but command-line instructions assume Windows/PowerShell by default.
Recommendations
- Explicitly state that Az CLI can be used on Linux/macOS and in Bash, Zsh, or other shells.
- Provide equivalent command-line instructions for Linux/macOS users (e.g., 'Open your terminal and run these commands').
- Avoid specifying 'PowerShell' unless the commands are genuinely PowerShell-specific; use 'terminal' or 'command prompt' for cross-platform clarity.
- If there are platform-specific steps (e.g., running as Administrator), clarify how Linux/macOS users can achieve the same (e.g., using 'sudo').
- Add a note or section for Linux/macOS users to ensure parity and inclusivity.
Create Pull Request