Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation exclusively uses PowerShell for all examples and instructions, which is primarily a Windows-centric tool. There are no examples using Bash, Azure CLI, or other cross-platform tools, nor is there any mention of Linux or macOS workflows. The use of PowerShell cmdlets and patterns (e.g., Select-AzSubscription, New-AzSubscriptionDeployment) reinforces a Windows-first approach and may alienate users on Linux or macOS who prefer Bash or Azure CLI.
Recommendations
- Provide equivalent examples using Azure CLI (az commands) and Bash scripts alongside PowerShell examples.
- Explicitly mention that the process can be performed on Linux/macOS and link to relevant cross-platform tooling.
- Add a section comparing PowerShell and Azure CLI approaches for deploying policies at scale.
- Avoid assuming PowerShell as the default and clarify prerequisites for each platform.
- Reference documentation for installing and using Azure CLI on Linux/macOS.
Create Pull Request