Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page demonstrates a mild Windows bias. In the 'Deploy template' section, Azure PowerShell (a Windows-centric tool) is presented before Azure CLI, and the PowerShell example is more visually prominent. The prerequisites mention both Azure PowerShell and Azure CLI, but PowerShell is listed first, which may subtly prioritize Windows users. There are no Linux-specific instructions, nor are there examples using bash or shell scripting. The verification and clean-up steps rely exclusively on the Azure portal, which is cross-platform, but do not mention CLI alternatives for Linux users.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first to avoid implicit prioritization of Windows tools.
- Include explicit bash or shell scripting examples for Linux users where applicable.
- In the prerequisites, clarify that Azure CLI is cross-platform and highlight its installation on Linux.
- Add instructions for verifying deployment and cleaning up resources using Azure CLI commands, not just the Azure portal.
- Where possible, avoid language that assumes use of Windows tools or patterns, and ensure parity in guidance for Linux users.
Create Pull Request