Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is given extensive coverage with multiple detailed scripts, including scenarios for availability sets and local execution. The CLI section is present and cross-platform, but is less detailed than PowerShell. The Terraform example references a Windows VM quickstart, and the code sample is for a Windows VM. There are no explicit Linux-specific examples, and Windows tools/patterns (PowerShell, Windows VM resource blocks) are mentioned first or exclusively in several places.
Recommendations
- Add explicit Linux VM examples in the Terraform section, referencing azurerm_linux_virtual_machine and providing sample code.
- Balance PowerShell and CLI coverage by expanding CLI examples to cover all scenarios shown for PowerShell, including availability sets and local execution.
- Reference Linux quickstart documentation alongside Windows quickstart in the Terraform section.
- Ensure that examples and code samples alternate or equally represent both Windows and Linux VMs.
- Add notes clarifying that Azure CLI commands work identically on Linux, macOS, and Windows, and provide shell script examples where appropriate.
Create Pull Request