Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias. PowerShell is featured prominently and is presented before Azure CLI in all code example sections. All CLI examples use PowerShell-style variable syntax (e.g., $rgname), which is not compatible with Bash or Linux shells. There are no Bash-specific examples, nor is there any mention of Linux shell usage or patterns. The documentation assumes familiarity with PowerShell and Windows tooling, potentially making it less accessible to Linux users.
Recommendations
- Provide Bash/Linux shell examples alongside PowerShell, using standard Bash variable syntax (e.g., rgname="<resource-group-name>") and command invocation.
- In CLI sections, use Bash-compatible syntax and avoid PowerShell-specific constructs when demonstrating Azure CLI commands.
- Alternate the order of examples, sometimes presenting Azure CLI (Bash) before PowerShell to avoid implicit prioritization.
- Explicitly mention that Azure CLI can be used on Linux, macOS, and Windows, and provide platform-specific installation links.
- Add a note clarifying that PowerShell examples are for Windows users, and Bash examples are for Linux/macOS users.
Create Pull Request