Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all operations, but consistently lists PowerShell as an equal alternative rather than a secondary option. However, there is a subtle Windows bias in the ordering and presentation: PowerShell is always presented alongside CLI, and never as a footnote or afterthought. There are no explicit Linux-specific instructions, nor is there mention of Bash or Linux shell environments, which may leave Linux users with questions about prerequisites or environment setup. The use of Azure CLI does provide cross-platform parity, but the documentation does not explicitly acknowledge or support Linux users beyond this.
Recommendations
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and that PowerShell examples are primarily for Windows or PowerShell Core users.
- Add a note or section about running Azure CLI in Bash or other Linux shells, including any environment setup steps if needed.
- If possible, provide Bash script examples or clarify that the CLI commands are intended for use in Bash or other Unix-like shells as well.
- Consider listing Azure CLI (cross-platform) examples first, and PowerShell (Windows-centric) examples second, to emphasize Linux parity.
- Include a brief statement in the prerequisites about supported operating systems and shells for each tool.
Create Pull Request