Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation mentions exporting policy and initiative definitions via PowerShell, CLI, or Azure Resource Graph, but lists PowerShell first and does not provide explicit Linux/macOS shell examples or mention cross-platform CLI usage in detail. There are no examples or instructions tailored for Linux/macOS users, and the workflow references Azure Pipelines and GitHub workflows without clarifying platform compatibility. The absence of Linux-specific instructions or parity in examples may create friction for non-Windows users.
Recommendations
- Explicitly provide CLI (az) command examples for all tasks alongside PowerShell, highlighting cross-platform compatibility.
- When listing tools or methods, alternate or balance the order (e.g., 'CLI, PowerShell, or Azure Resource Graph') to avoid Windows-first bias.
- Include notes or sections clarifying that all workflows and automation steps can be performed on Linux/macOS, with links to relevant setup guides.
- Add example scripts or code snippets using Bash/zsh for Linux/macOS users where appropriate.
- Mention and link to documentation for running Azure Pipelines and GitHub workflows from Linux/macOS agents.
Create Pull Request