Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is referenced repeatedly as the primary CLI example for policy management tasks, with no equivalent Bash, Azure CLI, or Linux shell examples provided. Windows-centric tools and patterns (such as PowerShell and references to Windows machines in sample policies) are mentioned exclusively or before Linux alternatives. There is a lack of parity in troubleshooting steps and code samples for Linux users, especially in sections involving policy duplication and compliance scans.
Recommendations
- Add equivalent Azure CLI and Bash examples alongside PowerShell commands for all policy management and troubleshooting tasks.
- Explicitly mention Linux and macOS compatibility for SDKs and tools where applicable.
- Provide sample policy definitions and troubleshooting steps for both Windows and Linux resource types, not just Windows machines.
- Ensure that references to Windows tools (e.g., PowerShell) are balanced with Linux alternatives (e.g., Bash, Azure CLI) and that examples are presented in parallel.
- Where portal or REST API instructions are given, clarify any OS-specific differences or limitations.
- Review and update sample scripts and code blocks to include Linux-friendly syntax and usage.
Create Pull Request