Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation provides command-line examples exclusively using Azure PowerShell, a tool most commonly used on Windows and less natively integrated on Linux/macOS. There are no CLI examples using Azure CLI (az), which is cross-platform and preferred by many Linux/macOS users. The structure presents PowerShell as the only scripting option, creating friction for non-Windows users. Additionally, the documentation refers to the Azure portal (web-based, cross-platform) and PowerShell, but omits Bash, Azure CLI, or ARM template examples.
Recommendations
- Add equivalent Azure CLI (az) command examples for all PowerShell instructions.
- Include Bash scripting examples where appropriate.
- Clarify that Azure PowerShell can be installed and used on Linux/macOS, but recommend Azure CLI for those platforms.
- Consider adding ARM template or Bicep examples for infrastructure-as-code parity.
- Present Azure CLI examples before or alongside PowerShell to avoid Windows-first perception.
Create Pull Request