Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a notable Windows bias. PowerShell is heavily featured, with explicit instructions and examples referencing 'Windows PowerShell' and using Windows-style paths (e.g., PS C:\Windows>). Installation steps and sign-in instructions are written for Windows environments, and references to 'Windows PowerShell' are frequent. While Azure CLI is cross-platform, CLI examples and outputs are often shown in a Windows PowerShell context, and MSI installer links are Windows-specific. There are no explicit Linux/macOS terminal examples, nor are there instructions for installing or running commands on those platforms. Linux and macOS users are left to infer how to adapt the instructions, which may cause confusion or friction.
Recommendations
- Add explicit Linux/macOS installation instructions for Azure CLI and PowerShell modules.
- Provide CLI and PowerShell command examples using Bash/zsh terminals (e.g., $ az login) alongside Windows PowerShell examples.
- Avoid using Windows-style paths and prompts exclusively; show equivalent Linux/macOS prompts (e.g., $ instead of PS C:\Windows>).
- Mention package managers for Linux/macOS (apt, yum, brew) for CLI and PowerShell installation.
- Clarify that Azure CLI and PowerShell are cross-platform, and provide links or notes for platform-specific guidance.
- Ensure screenshots and sample outputs are not exclusively from Windows environments.
Create Pull Request