Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by prioritizing Windows-specific tools and instructions, such as Azure PowerShell and ARMClient, and referencing Windows installation paths for Azure CLI. PowerShell examples are given first and in greater detail, while Linux-specific instructions, such as installing Azure CLI on Linux or using Bash, are missing. ARMClient is a Windows-only tool, and there is no mention of Linux alternatives or parity for command-line usage. The documentation lacks explicit Linux/Bash examples and does not address cross-platform differences.
Recommendations
- Include explicit instructions and examples for Linux users, such as installing Azure CLI on Linux and using Bash.
- Provide parity in example ordering, alternating or grouping PowerShell and CLI examples together, and avoid always presenting PowerShell first.
- Mention cross-platform compatibility for tools, or suggest Linux alternatives to ARMClient (e.g., curl, httpie, or az rest).
- Clarify when commands or tools are Windows-specific and provide equivalent Linux/macOS commands.
- Add notes or sections highlighting platform differences and ensuring all users can follow the documentation regardless of OS.
Create Pull Request