Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation demonstrates a moderate Windows bias, primarily through the use of PowerShell for provider registration and by presenting PowerShell examples before Linux-friendly CLI equivalents in key sections. The initial prerequisite for provider registration is shown only with PowerShell, and in the availability zones section, PowerShell is listed before REST and CLI, which may create friction for Linux/macOS users.
Recommendations
- Provide Azure CLI commands alongside PowerShell for all resource provider registration and management tasks, especially in the prerequisites section.
- Present CLI examples before PowerShell, or at least in parallel, to avoid implying Windows-first workflows.
- Explicitly mention that all commands can be run from Azure Cloud Shell, which is cross-platform.
- Where possible, include bash and shell script examples for Linux/macOS users.
- Add notes or links for Linux/macOS users on how to install and use Azure CLI.
Create Pull Request