Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples and instructions for three interfaces: Azure Portal, PowerShell, and Azure CLI. PowerShell is given equal prominence to Azure CLI, with detailed examples and explicit cmdlets. However, there is a notable absence of Linux-specific shell (e.g., Bash) examples, and PowerShell is traditionally associated with Windows environments. The documentation does not mention or provide parity for Linux-native scripting or tools, and PowerShell examples are presented before Azure CLI in every section, suggesting a Windows-first bias.
Recommendations
- Add explicit Bash shell examples for Linux users, especially for JSON manipulation and Azure CLI usage.
- Clarify that Azure CLI examples are cross-platform and can be run in Bash, Zsh, or other Linux shells.
- Consider reordering examples so that Azure CLI (the most cross-platform tool) appears before PowerShell.
- Mention that PowerShell is available on Linux, but provide guidance for users who prefer native Linux shells.
- Include troubleshooting or tips for Linux environments, such as handling JSON strings or environment variables in Bash.
- Ensure that screenshots and instructions do not assume a Windows environment (e.g., file paths, UI conventions).
Create Pull Request