Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a mild Windows bias by mentioning PowerShell as a primary export method before CLI, and by not providing explicit Linux shell or cross-platform examples for automation tasks. While Azure CLI is referenced, there are no bash or Linux-specific workflow samples, and PowerShell is listed first when discussing export options. There is also a lack of explicit mention of Linux-native tools or scripting patterns, and no guidance for Linux users on using shell scripts or integrating with Linux-based CI/CD systems.
Recommendations
- Provide explicit bash or shell script examples alongside PowerShell for exporting and managing policy definitions.
- Mention Azure CLI and bash scripting as equally valid options for automation, and avoid listing PowerShell first by default.
- Include references to Linux-based CI/CD systems (e.g., Jenkins, GitLab CI) in addition to GitHub Actions and Azure Pipelines.
- Add notes or sections on using Linux tools (e.g., jq for JSON manipulation) in policy workflows.
- Ensure that all automation steps are demonstrated in both Windows and Linux environments, or clarify cross-platform compatibility.
- Where SDKs or tools are referenced, specify their availability and usage on Linux.
Create Pull Request