Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides both Bash (Azure CLI) and PowerShell examples for most commands, but PowerShell examples are consistently present and sometimes more detailed, reflecting a Windows-centric approach. PowerShell is given parity with Bash, but the presence of PowerShell throughout, including resource creation, querying, and cleanup, indicates a bias toward Windows users. Additionally, Windows-specific tools (PowerShell cmdlets) are used extensively, and in some cases, PowerShell examples are more verbose or detailed than their Bash equivalents. There is no mention of Linux-specific patterns, troubleshooting, or alternative tools (e.g., native Linux networking commands).
Recommendations
- Ensure Bash/Azure CLI examples are as detailed as PowerShell examples, especially for complex resource creation steps.
- Add explicit notes or sections for Linux users, including troubleshooting tips for common Linux issues (e.g., permissions, environment variables).
- Consider including examples using native Linux tools (such as ip, netplan, or nmcli) where relevant, especially for networking concepts.
- Review the order of examples to avoid always listing PowerShell first or giving it more prominence.
- Where possible, provide cross-platform guidance (e.g., how to run Azure CLI on Windows, macOS, and Linux) and clarify that Bash examples work on all platforms with Azure CLI installed.
- Include a brief comparison table of Bash vs. PowerShell commands for quick reference.
Create Pull Request