Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by exclusively using PowerShell syntax for all Azure CLI and scripting examples, stating 'we're using PowerShell' without providing Bash or Linux shell equivalents. There are no Linux/macOS-specific instructions or examples, and variable assignment and command usage are tailored to PowerShell users. This may hinder accessibility for users on Linux or macOS platforms who use Bash or other shells.
Recommendations
- Provide parallel Bash/Linux shell examples for all Azure CLI commands and scripting steps, especially for variable assignment and command chaining.
- Explicitly mention that Azure CLI works cross-platform and that users can use Bash, zsh, or other shells on Linux/macOS.
- Where PowerShell-specific syntax is used (e.g., variable assignment with $Var = ...), show the Bash equivalent (e.g., VAR=...) side-by-side.
- In the prerequisites or opening sections, clarify that the tutorial is cross-platform and provide guidance for both Windows (PowerShell) and Linux/macOS (Bash) users.
- For clean-up and other scripting sections, ensure Bash alternatives are present and tested.
Create Pull Request