Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents Azure PowerShell examples before Azure CLI, and provides more detailed PowerShell usage patterns (such as formatting and JSON conversion) than CLI equivalents. PowerShell is a Windows-centric tool, while Azure CLI is cross-platform. However, CLI examples are present and comprehensive, and REST API usage is also covered. No critical functionality is Windows-only, but the ordering and depth of PowerShell examples may create friction for Linux/macOS users.
Recommendations
- Present Azure CLI examples before or alongside PowerShell examples to prioritize cross-platform usage.
- Ensure CLI examples cover all advanced usage shown in PowerShell (e.g., formatting, filtering, JSON output).
- Explicitly state that Azure CLI is cross-platform and recommend it for Linux/macOS users.
- Balance the depth of examples and explanations between PowerShell and CLI sections.
Create Pull Request