Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page exhibits moderate Windows bias. The main workflow for storing templates in Azure Storage is presented only as an Azure PowerShell script, with no equivalent Azure CLI or Bash example for Linux/macOS users. PowerShell is introduced first and in more detail, and instructions reference Windows-centric patterns (e.g., right-click to paste, $home variable, Read-Host prompts). While deployment is covered for both PowerShell and Azure CLI, the initial template upload and setup steps are Windows/PowerShell-only, creating friction for Linux/macOS users.
Recommendations
- Add an Azure CLI or Bash script example for uploading templates to Azure Storage, covering all steps currently shown only in PowerShell.
- Present CLI and PowerShell examples side-by-side or in parallel tabs throughout the tutorial, not just for deployment.
- Avoid Windows-centric instructions (e.g., right-click to paste) or provide platform-specific guidance.
- Clarify $home usage or replace with cross-platform environment variables (e.g., $HOME for Bash).
Create Pull Request