Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a notable Windows bias by providing only Azure PowerShell scripts for key steps such as downloading and uploading templates to Azure Storage, with no equivalent Bash or Azure CLI examples for Linux/macOS users. The PowerShell script is presented first and is the only option for storing templates, and instructions reference Windows-centric patterns (e.g., $home variable, right-click to paste, Cloud Shell defaults). While deployment is covered for both PowerShell and CLI, the initial setup is Windows/PowerShell-only.
Recommendations
- Add Bash/Azure CLI examples for downloading templates from GitHub and uploading them to Azure Storage, suitable for Linux/macOS users.
- Present CLI/Bash examples alongside PowerShell, or even before PowerShell, to ensure parity and inclusivity.
- Avoid Windows-specific instructions (e.g., right-click to paste) or provide alternatives for Linux/macOS terminals.
- Clarify that Cloud Shell supports both Bash and PowerShell, and show how to select Bash.
- Use cross-platform environment variables (e.g., $HOME or ~) and commands in examples.
Create Pull Request