Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents Azure PowerShell deployment instructions before Azure CLI, and uses PowerShell syntax and conventions (e.g., `$templateFile` variable) in both the prerequisites and deployment sections. While Azure CLI instructions are provided, there is a subtle preference for Windows/PowerShell tools and patterns, which may create friction for Linux/macOS users.
Recommendations
- Present Azure CLI instructions before or alongside PowerShell to avoid implicit prioritization of Windows tools.
- Clarify that `$templateFile` is a shell variable and provide equivalent Bash syntax for Linux/macOS users (e.g., `templateFile=path/to/template.json`).
- Explicitly mention that both Azure PowerShell and Azure CLI are cross-platform, and provide links or notes about installation and usage on Linux/macOS.
- Include screenshots or examples of the Azure portal on non-Windows platforms if relevant.
- Review terminology to avoid Windows-centric language (e.g., avoid assuming use of backticks for line continuation, which is PowerShell-specific).
Create Pull Request