Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a strong Windows bias in the sections describing how to generate and sanitize ARM templates for playbooks. The only provided method is a PowerShell script, with instructions and troubleshooting focused on Windows environments (Visual Studio Code, Windows PowerShell, PowerShell Core). There are no Linux or cross-platform alternatives mentioned, nor are there CLI/bash examples or notes about running the script on Linux/macOS. The documentation assumes familiarity with Windows tooling and does not address Linux users' needs.
Recommendations
- Provide equivalent instructions and examples for Linux and macOS users, such as using Azure CLI, Bash scripts, or cross-platform PowerShell (pwsh) with explicit Linux setup steps.
- Mention and link to cross-platform tools for ARM template generation and sanitization, or clarify PowerShell Core compatibility on Linux/macOS.
- Add troubleshooting notes for non-Windows environments (e.g., script execution policies, dependencies, file paths).
- Consider presenting Linux/macOS instructions before or alongside Windows instructions to avoid 'windows_first' bias.
- Explicitly state platform requirements and alternatives for each step involving tooling.
Create Pull Request