Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell examples are provided alongside Azure CLI, but there are no explicit Linux/macOS shell examples (e.g., bash), and variable syntax in CLI examples uses Windows-style ($Var) rather than POSIX-style (Var=Value). PowerShell is mentioned before CLI in several places, and instructions for installing Azure PowerShell are listed before Azure CLI. There are no references to Linux-specific tools or shell environments, and no guidance for Linux/macOS users regarding shell syntax differences.
Recommendations
- Add explicit bash/zsh shell examples for Azure CLI commands, using POSIX variable syntax (e.g., RgName="ResourceGroupName") instead of $RgName.
- Include notes or sections clarifying differences in variable usage between Windows (PowerShell) and Linux/macOS (bash/zsh) environments.
- Ensure CLI examples use cross-platform compatible syntax and avoid PowerShell-specific conventions.
- Present CLI and PowerShell instructions in parallel, or alternate their order, rather than consistently listing PowerShell first.
- Add references to Linux/macOS prerequisites (e.g., bash, zsh, or terminal usage) where relevant.
Create Pull Request