Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently presenting PowerShell examples alongside Azure CLI, often giving PowerShell equal or greater prominence. There is no mention of Linux-specific shell environments (e.g., Bash, zsh), nor are there any explicit Linux terminal examples or instructions. The installation and usage instructions for Azure CLI are generic, but all scripting examples are either Azure CLI (which is cross-platform) or PowerShell (which is Windows-centric, though available on Linux, but not the default). No Linux-native tools or shell patterns are shown, and PowerShell examples are provided for every operation, sometimes with more detail than CLI. There are no Bash or Linux shell script equivalents, and no guidance for Linux users on environment setup or command usage nuances.
Recommendations
- Add explicit Bash examples for all Azure CLI commands, using standard Linux shell syntax (e.g., export, $(...), etc.), and clarify that Azure CLI commands work natively in Bash/zsh/fish on Linux and macOS.
- Include notes or sections on installing Azure CLI and running Bicep deployments on Linux and macOS, including package manager instructions (apt, yum, brew).
- Clarify that PowerShell is available cross-platform, but is not the default shell on Linux/macOS, and provide guidance for users who prefer Bash.
- Where PowerShell is mentioned, add parallel Bash scripting examples for programmatic evaluation (e.g., using jq to parse JSON output from Azure CLI).
- Ensure that all examples and instructions are presented in a way that does not assume a Windows environment, and avoid giving PowerShell precedence over CLI or Bash.
Create Pull Request