Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a strong Windows bias. Windows PowerShell is consistently referenced as the default or primary environment for running Azure CLI commands, with explicit instructions and screenshots using Windows paths (e.g., PS C:\Windows>). Installation instructions and sample outputs are Windows-centric, and there is no mention or example of using Azure CLI on Linux or macOS terminals. PowerShell is treated as the main scripting environment, with no Bash or Linux shell equivalents provided for PowerShell-specific steps. The use of Windows-specific terminology and tools (e.g., MSI installers, Windows PowerShell version checks) further reinforces the bias. There are no Linux or macOS-specific examples, instructions, or screenshots, and the documentation does not acknowledge or guide users on how to perform these tasks in non-Windows environments.
Recommendations
- Provide explicit examples and instructions for running Azure CLI commands in Bash on Linux and macOS, including screenshots or sample outputs from those environments.
- When referencing Azure CLI, avoid defaulting to Windows PowerShell; instead, present both Bash and PowerShell options side-by-side, or use neutral language.
- Include installation instructions for Azure CLI on Linux and macOS, not just Windows (MSI installer).
- For PowerShell-specific steps, clarify that PowerShell Core is cross-platform and provide guidance for Linux/macOS users, or offer equivalent Bash scripts where possible.
- Replace Windows-specific paths and prompts (e.g., PS C:\Windows>) with generic or platform-appropriate alternatives, or show both.
- Add a section or note addressing platform differences and ensuring parity for Linux/macOS users.
Create Pull Request