Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias by exclusively providing PowerShell-based examples for all command-line operations, such as authentication, resource group creation, and role assignment. There are no CLI (az) or Bash/Linux/macOS shell equivalents, and PowerShell is assumed as the default automation tool. This creates friction for Linux and macOS users who typically use Azure CLI and Bash. Additionally, Windows-centric terminology (e.g., RDP admin credentials) is presented without Linux alternatives.
Recommendations
- Add Azure CLI (az) command examples alongside PowerShell for all resource management and deployment steps.
- Include Bash shell script snippets for Linux/macOS users.
- Mention SSH as an alternative to RDP for VM access, and clarify admin credential requirements for Linux VMs.
- Explicitly state that all steps can be performed from Linux/macOS and provide links to cross-platform tooling.
- Reorder examples so that CLI and PowerShell are presented together, or CLI first, to avoid Windows-first impression.
Create Pull Request