Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation demonstrates a moderate Windows bias. PowerShell is featured prominently and always before Azure CLI in code examples. The CLI examples use Windows-style variable assignment and login commands (Connect-AzAccount), which are PowerShell-specific and not applicable to Bash or Linux shells. There are no Linux/Bash-specific instructions, and the documentation does not mention Linux tools or shell patterns, nor does it provide parity for Linux users in example scripts.
Recommendations
- Provide Bash/Linux-native CLI examples, using standard Bash variable assignment (e.g., rgname="<resource-group-name>") and Azure CLI login (az login) instead of Connect-AzAccount.
- Clearly distinguish between PowerShell and CLI examples, and ensure CLI examples are platform-agnostic.
- Add explicit instructions for Linux users, including installation and usage notes for Azure CLI on Linux.
- Avoid using Windows/PowerShell-specific commands or syntax in CLI sections; use cross-platform commands.
- Consider listing CLI (Bash) examples before PowerShell to balance platform representation.
Create Pull Request