Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in several ways: PowerShell is given extensive coverage with multiple scripts and detailed explanations, while Linux-native tools (such as Bash or shell scripting) are not mentioned. The Terraform example references a Windows VM quickstart, and the CLI examples use generic shell syntax but do not provide explicit Linux/Bash examples or clarify cross-platform differences. Windows tools and patterns (PowerShell, Windows VM resource blocks) are mentioned before or instead of Linux equivalents, and there is a lack of Linux-specific guidance or examples.
Recommendations
- Add explicit Bash/shell script examples for resizing VMs using Azure CLI, highlighting any Linux-specific considerations.
- Provide Terraform examples for both azurerm_linux_virtual_machine and azurerm_windows_virtual_machine, with links to Linux quickstart guides.
- Balance the PowerShell section with equivalent Bash or cross-platform scripting guidance for Linux users.
- Clarify cross-platform differences in CLI usage, such as environment variables, quoting, and authentication steps for Linux.
- Reference Linux documentation and tools where relevant, and avoid referencing only Windows quickstarts or resources.
- Ensure that examples and explanations are presented in a platform-neutral order, or alternate between Windows and Linux where possible.
Create Pull Request