Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides detailed instructions for performing tasks using the Azure Portal and Azure PowerShell, with all CLI examples and automation scripts shown exclusively in PowerShell. There are no examples or guidance for using cross-platform tools such as Azure CLI, Bash, or other Linux-native approaches, which may disadvantage users on Linux or macOS systems. The PowerShell section is extensive and assumes familiarity with Windows-centric tooling, while Linux equivalents are absent.
Recommendations
- Add equivalent step-by-step instructions using Azure CLI (az) commands, which are cross-platform and widely used on Linux and macOS.
- Include Bash script examples for policy definition, assignment, and remediation tasks.
- Explicitly mention that PowerShell Core is available on Linux/macOS, but also provide Azure CLI alternatives for users who prefer native Linux tools.
- Review and update the documentation to ensure that Linux users can follow all steps without needing to switch to Windows or PowerShell.
- Consider adding a 'Platform parity' note at the top, clarifying which instructions apply to all platforms and linking to platform-specific guides if necessary.
Create Pull Request