Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation exclusively uses Azure PowerShell cmdlets for all examples, with no mention of Azure CLI, Bash, or cross-platform alternatives. All code samples are in PowerShell, which is most commonly used on Windows, and there are no equivalent instructions or examples for Linux/macOS users. The documentation also references Windows-centric patterns (e.g., PowerShell pipelines, cmdlet naming conventions) without noting how Linux users can achieve the same tasks.
Recommendations
- Provide equivalent Azure CLI (az) examples for all major steps, including querying Resource Graph, deploying policies, validating deployment, and cleaning up resources.
- Explicitly mention that PowerShell Core is available on Linux/macOS, and clarify any differences or prerequisites for running these scripts cross-platform.
- Add Bash script examples or at least CLI commands to ensure Linux/macOS users can follow the documentation without friction.
- Reorder or parallelize examples so that Linux/macOS-friendly approaches (CLI, Bash) are presented alongside PowerShell, not only after or below it.
Create Pull Request