Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for role assignment and tenant deployment commands, but PowerShell is consistently shown before CLI in key permission setup steps. The initial example for assigning permissions uses PowerShell first, and the PowerShell command is presented with syntax highlighting and explanation before the CLI equivalent. There is no mention of Linux-specific considerations, nor are Linux/macOS shell patterns (e.g., bash, zsh) discussed. However, Azure CLI is cross-platform and examples are provided for it, so Linux users can complete all tasks.
Recommendations
- Present Azure CLI examples before PowerShell examples, as CLI is cross-platform and preferred for Linux/macOS users.
- Explicitly mention that Azure CLI works on Linux/macOS and provide links or notes for installing Azure CLI on those platforms.
- Add a brief note that PowerShell examples are primarily for Windows users, and recommend Azure CLI for Linux/macOS.
- Ensure that any references to Cloud Shell clarify that both Bash and PowerShell environments are available.
Create Pull Request