Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation consistently provides PowerShell examples and instructions, often with explicit directions to 'Open PowerShell as Administrator', which is a Windows-specific pattern. PowerShell examples are given equal prominence to Azure CLI, but the language and instructions (e.g., 'as Administrator') are Windows-centric. There is no mention of Bash, Linux shells, or cross-platform scripting environments, and no guidance for Linux users on using PowerShell Core or alternative shells. The ordering of tabs sometimes places PowerShell before CLI, reinforcing a Windows-first approach.
Recommendations
- Clarify that PowerShell examples can be run cross-platform using PowerShell Core, and provide instructions for Linux/macOS users where appropriate.
- Avoid instructions like 'Open PowerShell as Administrator' unless necessary, or provide equivalent Linux/macOS instructions (e.g., 'Open a terminal').
- Explicitly mention that Azure CLI commands can be run in Bash, zsh, or other Linux/macOS shells, and provide example commands for those environments if there are differences (e.g., quoting, environment variables).
- Consider reordering tabs or examples so that Azure CLI (which is cross-platform) appears before PowerShell, or at least alternate the order to avoid implicit prioritization.
- Where possible, add Bash script examples or note that Azure CLI is the recommended tool for Linux/macOS users.
- If PowerShell is required, mention how to install and use PowerShell Core on Linux/macOS.
Create Pull Request