Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias, primarily through the exclusive use of Azure PowerShell examples for key troubleshooting steps (e.g., duplicating policy definitions with metadata). There are no CLI (az), Bash, or Linux/macOS-specific examples provided, and PowerShell is referenced as the primary automation tool for tasks that could be performed cross-platform. Additionally, Windows terminology and tools are mentioned first or exclusively in some scenarios, with no Linux parity in examples or instructions.
Recommendations
- Provide equivalent examples using Azure CLI (az) and Bash scripts for all PowerShell-based instructions, especially for duplicating policy definitions and triggering on-demand evaluation scans.
- Explicitly mention cross-platform support and clarify which steps can be performed on Linux/macOS, not just Windows.
- Where PowerShell is referenced, add a note or link to Linux/macOS alternatives.
- Ensure that troubleshooting steps do not assume the use of Windows-only tools or environments.
- Add examples for common Linux tools (e.g., curl, jq) where appropriate, especially in sections about REST API usage.
Create Pull Request