Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a mild Windows bias. In the 'Source control' section, PowerShell is listed first when discussing export options, before CLI or Azure Resource Graph, suggesting a Windows-first approach. There are no explicit Linux shell (bash) or cross-platform CLI examples provided, nor is there mention of Linux-specific tools or workflows. The documentation references Azure Pipelines and GitHub workflows for deployment, which are cross-platform, but does not provide parity in example commands or scripts for Linux users. No explicit PowerShell scripts are shown, but the mention of PowerShell as a primary export method and lack of Linux-specific guidance or examples indicates a subtle bias.
Recommendations
- Provide explicit bash/Azure CLI examples alongside PowerShell for common tasks such as exporting policy definitions.
- When listing tools or methods, alternate or balance the order (e.g., CLI first, then PowerShell) to avoid Windows-first perception.
- Include references to Linux-based automation workflows (e.g., shell scripts, cron jobs) where relevant.
- Clarify that all steps can be performed on Linux, macOS, and Windows, and link to platform-specific guidance if available.
- Add sample scripts or commands for both PowerShell and bash/CLI in relevant sections.
Create Pull Request