Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all deployment and management tasks. However, PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and in some cases, Windows-specific patterns (such as PowerShell array syntax) are shown. There is implicit Windows bias in the use of PowerShell and the lack of explicit Linux shell examples (e.g., Bash array syntax), and Windows tools (PowerShell) are mentioned as primary options alongside CLI, rather than CLI being the default cross-platform choice. There are no Bash or Linux-native command examples, and variable assignment patterns are PowerShell-specific in the PowerShell tabs.
Recommendations
- Add explicit Bash shell examples for variable assignment and command usage, especially for Linux/macOS users.
- Clarify that Azure CLI is cross-platform and recommend it as the default for non-Windows environments.
- Instruct users on how to assign arrays/variables in Bash for CLI commands (e.g., using bash arrays or strings).
- Consider reordering examples so that Azure CLI (cross-platform) appears before PowerShell (Windows-centric) in each section.
- Add notes or callouts for Linux/macOS users regarding shell differences and how to adapt examples.
- Avoid assuming PowerShell is available on all platforms; mention installation steps if needed.
Create Pull Request