Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides examples for Azure Portal, PowerShell, CLI, and Terraform, but consistently lists PowerShell (a Windows-centric tool) before CLI (cross-platform) in both prerequisites and step-by-step instructions. PowerShell examples are detailed and extensive, matching the CLI coverage, but are presented first, which may subtly prioritize Windows workflows. No critical Linux functionality is missing, and Linux VM creation is included in all methods.
Recommendations
- Alternate the order of PowerShell and CLI sections, or present CLI examples before PowerShell to avoid implicit prioritization.
- Explicitly note that Azure CLI and Cloud Shell are cross-platform and suitable for Linux/macOS users.
- Add a short note in the prerequisites clarifying that PowerShell is available in Cloud Shell and on macOS/Linux, but CLI is generally preferred for cross-platform usage.
- Ensure that any advanced scenarios or troubleshooting are equally covered for CLI and PowerShell.
Create Pull Request