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 alongside Azure CLI and Portal, with PowerShell often mentioned first or equally with CLI. There is no mention of Linux-specific shell usage (e.g., Bash), nor are there examples tailored for Linux environments. The prerequisites and instructions reference PowerShell modules and cmdlets, which are Windows-centric, without offering equivalent Bash or Linux-native instructions. The documentation assumes familiarity with PowerShell and does not address Linux users' needs or potential differences in experience.
Recommendations
- Add explicit Bash shell examples for Azure CLI commands, demonstrating usage in a Linux environment.
- Clarify that Azure CLI commands are cross-platform and provide instructions for installing and using Azure CLI on Linux.
- Reorder examples to present Azure CLI (Bash) first, followed by PowerShell, to reduce Windows-first perception.
- Include notes or sections addressing Linux users, such as troubleshooting tips, environment setup, or differences in authentication flows.
- Where PowerShell modules are referenced, also mention Linux alternatives or clarify that PowerShell Core is available cross-platform.
- Review screenshots and instructions to ensure they are not Windows-specific (e.g., avoid showing Windows-only UI elements or paths).
Create Pull Request