Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page exhibits a Windows bias primarily through the heavy use of PowerShell for command-line examples and deployment instructions. PowerShell commands are presented as the main or only method for key operations such as deploying Resource Manager templates, managing Key Vault access policies, and retrieving service principal IDs. While Azure CLI is mentioned for some Key Vault operations, it is not used for deployment or identity management examples. There are no explicit Linux shell (bash) or cross-platform CLI examples for template deployment or identity management, and PowerShell is referenced before Azure CLI in several places. This may disadvantage users on Linux or macOS who do not use PowerShell.
Recommendations
- Provide Azure CLI (bash) equivalents for all PowerShell commands, especially for template deployment and identity management tasks.
- Include explicit instructions and examples for Linux/macOS users, such as using Azure CLI in bash or sh.
- Where both PowerShell and CLI are supported, present CLI examples first or side-by-side with PowerShell to avoid implicit prioritization of Windows tools.
- Clarify that all operations can be performed from Linux/macOS using Azure CLI, and link to relevant cross-platform documentation.
- Consider adding a section or tabbed examples for 'Windows (PowerShell)' and 'Linux/macOS (CLI)' to improve parity and accessibility.
Create Pull Request