Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides command-line examples for Azure PowerShell before Azure CLI, and the PowerShell section is more detailed and prominent. This ordering and emphasis can create friction for Linux/macOS users, as PowerShell is a Windows-centric tool, while Azure CLI is cross-platform. However, Azure CLI, Python, and REST API examples are present, so Linux users can complete all tasks.
Recommendations
- Present Azure CLI examples before Azure PowerShell, as CLI is cross-platform and preferred by many Linux/macOS users.
- Explicitly note that Azure CLI works on Windows, Linux, and macOS, while PowerShell is most common on Windows.
- Balance the detail and coverage between PowerShell and CLI sections, ensuring parity in example depth and explanation.
- Consider adding Bash shell script examples for common tasks, as Bash is native to Linux/macOS.
- Add a short section at the start clarifying tool/platform compatibility for each method.
Create Pull Request