Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Windows First
Summary
The documentation page demonstrates a notable Windows bias, particularly in sections involving command-line operations and automation. Most step-by-step instructions for deploying templates, managing identities, and configuring access policies use PowerShell commands exclusively, with no Bash or Linux CLI equivalents provided. References to 'PowerShell' are frequent and examples are given only in PowerShell syntax, even though Azure CLI is cross-platform and could be used. This creates friction for Linux/macOS users who may not have access to PowerShell or prefer Bash. Additionally, Windows-centric tools and patterns (e.g., PowerShell cmdlets, 'New-AzResourceGroupDeployment', 'Set-AzureRmKeyVaultAccessPolicy') are mentioned before or instead of their cross-platform alternatives.
Recommendations
- Provide Azure CLI (az) command equivalents for all PowerShell examples, especially for resource deployment and access policy management.
- Explicitly state that all operations can be performed using Azure CLI on Linux/macOS, and link to relevant CLI documentation.
- Where possible, show both PowerShell and Bash/CLI examples side-by-side, or use tabs to allow users to select their preferred environment.
- Clarify prerequisites for Linux/macOS users, such as installing Azure CLI, and avoid assuming PowerShell is available.
- Review screenshots and UI instructions to ensure they are not Windows-specific.