Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation consistently presents Azure PowerShell examples before Azure CLI, and all command-line examples are limited to PowerShell and Azure CLI without explicit mention of Linux shell environments or cross-platform differences. There are no references to Linux-specific tools, shell syntax, or considerations for non-Windows users. The use of PowerShell is prominent, and there is an implicit assumption that users are familiar with PowerShell, which is primarily a Windows technology (though available on Linux, it is less commonly used there). No examples are given for Bash, zsh, or other Linux-native shells, nor are there notes about platform-specific differences.
Recommendations
- Explicitly state that Azure CLI commands work on both Windows and Linux, and provide Bash/zsh syntax where relevant (e.g., use $() for command substitution in CLI examples).
- Add notes or sections highlighting any platform-specific differences, such as file path formats, environment variable usage, or installation steps for Azure CLI and PowerShell on Linux.
- Include examples using Bash shell syntax for Azure CLI, especially for variable assignment and command chaining.
- Clarify that PowerShell is available on Linux but is less commonly used, and recommend Azure CLI for Linux users.
- Consider adding troubleshooting tips or links for Linux users, such as dealing with file permissions or installing dependencies.
Create Pull Request