Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a bias toward Windows environments by consistently presenting PowerShell examples alongside Azure CLI and Portal, with PowerShell mentioned before CLI in prerequisites and examples. There are no explicit Linux shell (bash) examples, nor is there mention of Linux-specific usage patterns or tools. The CLI examples are generic and do not clarify Linux-specific nuances, and PowerShell is treated as a primary interface, which is more common on Windows.
Recommendations
- Add explicit bash shell examples for Azure CLI usage, including login and query commands, to demonstrate parity for Linux users.
- Clarify that Azure CLI commands work cross-platform and provide notes or examples for Linux/macOS environments (e.g., handling authentication, environment variables).
- Reorder prerequisites and examples to present Azure CLI before PowerShell, or present both equally, to avoid Windows-first impression.
- Include troubleshooting or tips relevant to Linux environments, such as installation steps for Azure CLI on Linux, or common issues.
- Mention that PowerShell Core is available cross-platform, but clarify its usage on Linux/macOS if PowerShell examples are retained.
Create Pull Request