Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation provides detailed Azure PowerShell examples for all CLI-based operations but does not include any Azure CLI (az) or Bash examples, which are preferred by Linux/macOS users. PowerShell is a Windows-centric tool, and its usage is described and required for all command-line instructions. There is no mention of Azure CLI, Bash, or cross-platform scripting alternatives, and PowerShell instructions are presented before any mention of Linux-compatible tools. This creates friction for Linux/macOS users who may not have PowerShell installed or prefer native tools.
Recommendations
- Add equivalent Azure CLI (az) command examples for all operations alongside PowerShell examples.
- Include Bash script snippets for common tasks where appropriate.
- Explicitly mention that Azure CLI is cross-platform and provide installation instructions for Linux/macOS.
- Reorder examples so that Azure CLI/Bash instructions are presented before or alongside PowerShell, not after.
- Clarify that PowerShell Core is available for Linux/macOS, but recommend Azure CLI for native experience.
Create Pull Request