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 presented immediately after CLI examples. There are no Linux-specific shell examples (e.g., Bash, zsh), nor is there explicit mention of Linux/macOS compatibility for the CLI commands. The 'Before you begin' section lists Azure PowerShell alongside Azure CLI, potentially implying parity or preference for Windows tooling. However, the Azure CLI is cross-platform and all provided CLI commands are compatible with Linux/macOS.
Recommendations
- Clarify that Azure CLI commands work on Linux, macOS, and Windows.
- Consider listing Azure CLI examples first and PowerShell second, as CLI is cross-platform.
- Add explicit notes or callouts for Linux/macOS users, confirming that all CLI commands are supported on their platforms.
- Remove or de-emphasize PowerShell instructions unless there is a Windows-specific scenario.
- Include example shell environments (e.g., Bash) in screenshots or outputs where relevant.
Create Pull Request