Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a Windows bias by consistently presenting Azure PowerShell instructions alongside Azure CLI, referencing PowerShell modules and patterns, and listing PowerShell examples before CLI equivalents. There is no mention of Linux-specific shell environments (e.g., bash), nor are there examples tailored for Linux users. The documentation assumes familiarity with Windows tools and workflows, potentially disadvantaging Linux-first users.
Recommendations
- Explicitly mention that Azure CLI and PowerShell are cross-platform, and clarify which instructions apply to Linux, macOS, and Windows.
- Provide bash shell examples for Linux users, especially for installation and resource provider registration steps.
- Include notes or sections on using Azure CLI from Linux/macOS, including prerequisites and troubleshooting tips.
- Avoid listing PowerShell instructions before CLI or alternate shell instructions; alternate between them or group by platform.
- Reference Linux-native tools and workflows where appropriate, such as using package managers (apt, yum, brew) for CLI installation.
- Clarify that Helm and Azure CLI can be installed and used on Linux, and provide explicit instructions for doing so.
Create Pull Request