Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently presenting PowerShell examples before Azure CLI examples, referencing PowerShell-specific cmdlets, and omitting explicit Linux shell (bash) or cross-platform scripting examples. While Azure CLI is included, there are no Linux-specific instructions, screenshots, or notes about platform differences. The use of PowerShell is emphasized, and the CLI examples are sometimes described in the context of PowerShell, further reinforcing the Windows-centric approach.
Recommendations
- Alternate the order of examples, sometimes presenting Azure CLI (bash) before PowerShell to avoid Windows-first bias.
- Include explicit bash shell examples, with Linux-specific notes or screenshots where appropriate.
- Add a section discussing platform compatibility, clarifying that Azure CLI works on Linux, macOS, and Windows, and providing guidance for Linux users.
- Avoid language that frames CLI examples in terms of PowerShell (e.g., 'uses an Azure PowerShell command' in the CLI section).
- Where possible, provide cross-platform instructions for prerequisites and environment setup.
- Consider adding troubleshooting notes for common Linux-specific issues (e.g., permissions, environment variables).
Create Pull Request