Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides parallel instructions for Azure CLI, Azure PowerShell, and Azure Portal, but consistently includes Azure PowerShell examples and commands, which are primarily used on Windows. The PowerShell sections are always present and often listed before or alongside CLI, and there is no mention of Bash, shell scripting, or Linux-specific considerations. There are no Linux-specific examples or notes about cross-platform differences, and PowerShell is presented as a first-class option, which may bias the documentation toward Windows users.
Recommendations
- Explicitly state that Azure CLI commands work cross-platform (Windows, Linux, macOS) and highlight this in the introduction.
- Add Bash or shell script examples where scripting is relevant, especially for automation scenarios.
- Clarify that Azure PowerShell is available on Linux and macOS via PowerShell Core, or provide guidance for Linux users if there are differences.
- Consider listing Azure CLI before PowerShell in all sections, as CLI is more universally cross-platform.
- Add a note or section on using these commands in Linux environments, including any prerequisites or differences (e.g., shell quoting, authentication).
- Avoid implying that PowerShell is the default or primary automation tool for all users.
Create Pull Request