Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias primarily through the exclusive use of PowerShell commands for deployment and configuration tasks, with no Bash or Linux shell equivalents provided. PowerShell is referenced as the main method for key vault configuration, access policy management, and ARM template deployment. There are no explicit instructions or examples for Linux users (e.g., Bash, sh, or cross-platform Azure CLI usage outside of az commands), and PowerShell commands are presented first and exclusively in all relevant sections.
Recommendations
- Provide equivalent Bash or shell script examples for all PowerShell commands, especially for ARM template deployment and key vault access policy management.
- Explicitly mention that Azure CLI commands are cross-platform and can be run on Linux, macOS, and Windows, and prefer CLI examples where possible.
- Add a section or callouts for Linux/macOS users, clarifying how to perform these operations without PowerShell.
- Where PowerShell is used, offer the Azure CLI alternative first, or at least side-by-side, to avoid implying Windows is the default or preferred platform.
- Ensure that all instructions referencing PowerShell also include links or references to how to install and use Azure CLI on Linux/macOS.
Create Pull Request