Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently presenting Azure PowerShell examples alongside Azure CLI, with PowerShell commands and patterns featured as primary options. There is a lack of explicit Linux or Bash shell examples, and installation instructions reference PowerShell modules without mentioning Linux-specific setup. The CLI examples are generic and do not clarify cross-platform usage, while PowerShell (a Windows-centric tool) is given equal or greater prominence throughout. No Linux-specific tools, shell patterns, or troubleshooting are discussed.
Recommendations
- Add explicit Bash and Linux shell examples for all CLI commands, including environment setup and variable assignment.
- Clarify that Azure CLI is cross-platform and provide instructions for installation and usage on Linux and macOS.
- Include troubleshooting or configuration notes relevant to Linux environments (e.g., file permissions, path separators, environment variables).
- Present CLI/Bash examples before PowerShell examples to reduce Windows-first bias.
- Reference Linux-native editors and tools (e.g., Vim, Nano) when discussing editing Bicep files.
- Mention that PowerShell Core is available cross-platform, but clarify differences in usage between Windows and Linux.
Create Pull Request