Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a notable Windows bias. The main example for storing templates in Azure uses only Azure PowerShell, with no equivalent Azure CLI or Bash script for Linux/macOS users. The PowerShell script is presented first and in more detail, while the Azure CLI example is only provided for the deployment step, not for the template upload/storage step. The instructions and Cloud Shell guidance are tailored to PowerShell, and Windows-centric tools and patterns (e.g., PowerShell cmdlets, Windows-style file paths) are used exclusively or before Linux equivalents. Minor notes about macOS compatibility are present, but overall, Linux/macOS users must adapt or research their own solutions for key steps.
Recommendations
- Provide a complete Azure CLI or Bash example for storing templates in Azure Storage, including downloading files from GitHub and uploading them to a blob container.
- Present CLI/Bash examples alongside PowerShell, not only for deployment but also for setup and resource creation.
- Add explicit instructions for Linux/macOS users, including file path conventions and command differences.
- Ensure that Cloud Shell instructions clarify how to select Bash/CLI, not just PowerShell.
- Avoid presenting Windows/PowerShell examples first; alternate or parallelize example order.
Create Pull Request