Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias by exclusively using PowerShell syntax for all Azure CLI and scripting examples, even though Azure CLI is cross-platform. There are no Bash or Linux shell equivalents provided for common tasks such as variable assignment, resource creation, or role assignment. The page also explicitly states 'we're using PowerShell' in the tutorial setup, and Windows/PowerShell examples are presented first and exclusively. Only the Python SDK and a single curl command use Bash, but all Azure CLI usage is shown in PowerShell style.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell examples, especially for Azure CLI commands and variable assignment.
- Clarify that Azure CLI works on all platforms and users can choose their preferred shell.
- Present both Windows (PowerShell) and Linux/macOS (Bash) examples side by side, or default to Bash for CLI commands since it is more universally applicable.
- Avoid using PowerShell-specific variable assignment ($Var = ...) in CLI examples, as this is not portable.
- Add a note or section for Linux/macOS users outlining any differences or considerations.
Create Pull Request