Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all upgrade operations, but PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and is always listed immediately after CLI examples. There are no Linux-specific shell examples (e.g., Bash), nor any mention of Linux/macOS platform nuances. The CLI examples are cross-platform, but the presence and prominence of PowerShell may suggest a Windows bias, especially for users unfamiliar with PowerShell on non-Windows systems.
Recommendations
- Clarify that Azure CLI commands work natively on Linux/macOS and Windows, while PowerShell is primarily a Windows tool (though cross-platform PowerShell exists).
- Consider listing Azure CLI examples first, as it is the most cross-platform tool.
- Add explicit Bash shell examples or notes for Linux/macOS users where relevant (e.g., environment variable usage, file paths).
- Add a note or section addressing platform compatibility for both CLI and PowerShell.
- If PowerShell is not required for any step, consider de-emphasizing it or moving it to an appendix.
Create Pull Request