Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page demonstrates Windows bias by listing Windows-centric tools (PowerShell, Azure classic CLI) before mentioning REST API, and omitting explicit Linux or cross-platform CLI examples. The code samples section does not reference command-line usage, and the instructions for assigning roles mention PowerShell and the Azure classic CLI (both Windows-focused) before REST API, with no mention of the cross-platform Azure CLI. There are no Linux-specific or cross-platform shell examples, and the documentation implicitly prioritizes Windows tools and patterns.
Recommendations
- Add explicit instructions and examples for using the cross-platform Azure CLI (az), which is widely used on Linux and macOS.
- Include bash or shell script examples alongside PowerShell, especially for common management tasks.
- Reorder tool mentions to list cross-platform options (Azure CLI, REST API) before Windows-specific tools (PowerShell, classic CLI).
- Clarify that all management operations can be performed from Linux, macOS, and Windows, and provide parity in examples.
- Add a section or note highlighting cross-platform support and linking to installation guides for Azure CLI on Linux/macOS.
Create Pull Request