Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Linux and Windows shell examples in the shell table, but there is a notable emphasis on Azure PowerShell (Windows-centric) as a primary tool alongside Azure CLI. Windows tools and conventions (cmd, PowerShell) are mentioned explicitly and sometimes before Linux equivalents. However, Linux shell usage is demonstrated in examples, and the Azure CLI (cross-platform) is used for all step-by-step instructions. There are no exclusive Windows-only instructions, but the presence of PowerShell and Windows shell references may create mild friction for Linux/macOS users.
Recommendations
- Add explicit Linux/macOS PowerShell alternatives or clarify that Azure CLI is cross-platform and preferred for non-Windows users.
- Reorder shell table to list Linux shells first (e.g., Ubuntu, Alpine) before Windows (cmd) to reduce Windows-first perception.
- Provide a Linux/macOS-specific example for Resource Manager templates or YAML files, showing command-line overrides in a native editor or workflow.
- Clarify that PowerShell is optional and not required for Linux/macOS users.
- Add a note that Azure CLI commands work identically on Linux, macOS, and Windows.
Create Pull Request