Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias by providing only PowerShell-based command-line examples for resource creation, role assignment, and deployment. There are no equivalent examples using Bash, Azure CLI, or Linux/macOS-native tools. Additionally, VM image properties in the ARM template examples exclusively reference Windows Server images, with no mention of Linux-based node types or images. This prioritization of Windows tools and patterns creates friction for Linux/macOS users.
Recommendations
- Add Azure CLI (az) command examples alongside PowerShell for all resource creation, role assignment, and deployment steps.
- Include Bash script snippets for template deployments and identity management.
- Show ARM template examples using Linux VM images (e.g., Ubuntu) in addition to Windows Server.
- Explicitly mention cross-platform compatibility and provide guidance for Linux/macOS environments.
- Clarify that PowerShell commands can be run on Linux/macOS via PowerShell Core, or provide alternatives.
Create Pull Request