Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a moderate Windows bias. PowerShell is given a prominent, detailed section with multiple scripts and explanations, while Linux-native tooling (e.g., Bash, shell) is not mentioned outside of Azure CLI. The Terraform example references Windows VM quickstart, and the CLI examples use Bash syntax but do not explicitly address Linux-specific considerations. Windows terminology and tools (PowerShell, Windows VM resource blocks) are introduced before Linux equivalents, and the workaround for temp disk migration links to a Windows-specific article. There are no explicit Linux shell or macOS Terminal examples, and Linux users may need to infer steps from the CLI section.
Recommendations
- Add explicit Linux/macOS shell examples for resizing VMs using Azure CLI, including notes on environment setup and differences (e.g., quoting, variable syntax).
- Provide parity in Terraform examples by referencing both Windows and Linux VM quickstarts, or showing a generic example.
- Ensure workaround and migration links include Linux VM scenarios, not just Windows.
- Balance PowerShell and CLI coverage, and introduce CLI examples before or alongside PowerShell to avoid Windows-first impression.
- Clarify that Azure CLI commands work cross-platform and highlight any OS-specific caveats.
Create Pull Request