Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page for resizing an Azure virtual machine exhibits several forms of Windows bias. PowerShell is given extensive, detailed coverage with multiple scripts and explanations, while Linux-native tools (such as Bash or cloud-init) are not mentioned. The CLI section uses Bash syntax but is not explicitly labeled as a Linux example, and the Terraform section references only a Windows VM quickstart. There are no explicit Linux-specific examples or guidance, and PowerShell is presented before CLI or Terraform, reinforcing a Windows-first perspective.
Recommendations
- Add explicit Linux/Bash examples for resizing VMs, including using the Azure CLI from a Linux shell and mentioning any Linux-specific considerations.
- In the Terraform section, include both Linux and Windows VM resource block examples, or link to both quickstarts.
- Balance the order of examples: consider presenting Azure CLI (cross-platform) before PowerShell, or clarify that PowerShell is available on Linux/macOS as well.
- Where possible, mention that Azure CLI commands can be run natively on Linux/macOS, and provide any relevant troubleshooting tips for those platforms.
- If there are Linux-specific limitations or best practices (e.g., for cloud-init, SSH, etc.), include them.
Create Pull Request