Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation provides detailed PowerShell examples and explanations for resizing Azure VMs, including both general and availability set scenarios, before presenting Azure CLI and Terraform options. The PowerShell sections are more extensive and include local usage and authentication steps, which are Windows-centric. The Terraform example references only a Windows VM quickstart, and there is no explicit Linux-focused example or mention of Linux-specific considerations. While the CLI examples are cross-platform, the overall structure and example selection favor Windows users.
Recommendations
- Add explicit Linux-focused examples, especially in the Terraform section (e.g., link to or show an azurerm_linux_virtual_machine block and a Linux quickstart).
- Balance the PowerShell and CLI sections in terms of detail and explanation, ensuring CLI (which is cross-platform) is not treated as secondary.
- In the Terraform section, provide both Windows and Linux resource block examples or link to both quickstarts.
- Where possible, clarify that CLI commands work on all platforms and highlight any OS-specific considerations.
- Consider presenting CLI examples before PowerShell, as CLI is cross-platform and PowerShell is primarily Windows-focused (though available on Linux, it is less common there).
Create Pull Request