Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides detailed PowerShell examples for creating and managing Azure Policy definitions, including file path examples using Windows-style paths (e.g., 'c:\policies\coolAccessTier.json'). PowerShell is presented before Azure CLI, and there are no explicit Linux/macOS shell (bash) examples or notes about cross-platform usage. The REST API and Azure CLI sections are platform-neutral, but the PowerShell focus and Windows file paths may create friction for Linux/macOS users.
Recommendations
- Add explicit Linux/macOS shell (bash) examples for creating policy definitions, including file paths using POSIX style (e.g., '/home/user/policies/coolAccessTier.json').
- Clarify that Azure CLI commands work cross-platform and provide sample usage in bash/zsh.
- Add notes or callouts indicating how Linux/macOS users should adapt PowerShell and file path examples.
- Consider presenting Azure CLI examples before PowerShell to emphasize cross-platform support.
- Avoid using Windows-specific file paths in generic examples, or provide both Windows and Linux/macOS variants.
Create Pull Request