Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page demonstrates a mild Windows bias by listing Azure PowerShell deployment instructions before Azure CLI, and by referencing Azure PowerShell as a primary tool in the prerequisites. While both PowerShell and CLI examples are provided, PowerShell is presented first and is more closely associated with Windows environments. There are no explicit Linux-specific instructions, nor is there mention of Linux tools or shell patterns (e.g., bash, zsh), and the CLI example uses generic syntax without platform-specific context.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI first to avoid implicit prioritization of Windows tools.
- Explicitly mention that Azure CLI works cross-platform (Windows, Linux, macOS) and provide examples of running CLI commands in bash/zsh shells.
- Add notes or examples for Linux users, such as setting environment variables or file paths in Linux shell syntax.
- Reference Linux-native editors (e.g., Vim, nano) alongside Visual Studio Code, or clarify that VS Code is cross-platform.
- Ensure troubleshooting notes include both PowerShell and CLI switches (e.g., --verbose, --debug for CLI) and clarify their usage in different environments.
Create Pull Request