Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in its Azure CLI section by exclusively providing PowerShell-based examples and variable assignments, which are specific to Windows environments. There are no Bash or Linux shell equivalents provided, and the command syntax (e.g., use of `$variable` and backticks for line continuation) is tailored for PowerShell, making it less accessible for Linux or macOS users. The documentation also presents the Windows/PowerShell approach first and omits any mention of Linux-specific tools or patterns.
Recommendations
- Provide equivalent Bash examples for all Azure CLI commands, including variable assignment and command execution.
- Clearly indicate which examples are for PowerShell and which are for Bash, using tabs or callouts.
- Avoid using PowerShell-specific syntax (such as backticks for line continuation) in generic CLI documentation, or provide alternatives for Bash.
- Mention cross-platform compatibility of Azure CLI and provide guidance for both Windows and Linux/macOS users.
- Include notes or links to Linux prerequisites or troubleshooting steps where relevant.
Create Pull Request