Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation page shows mild Windows bias. It references PowerShell-specific deployment behavior and parameter naming conflicts, and discusses the PowerShell cmdlet New-AzResourceGroupDeployment without mentioning equivalent Azure CLI or Linux-native tools. In the section on connecting to virtual machines, Windows connection methods (RDP, WinRM) are listed before Linux, and two Windows-specific links are provided versus one for Linux. There are no explicit Linux shell or Azure CLI examples, and the only mention of Linux is in a link to 'Connect to a Linux VM.'
Recommendations
- When discussing parameter naming conflicts, mention both PowerShell and Azure CLI behaviors, and provide equivalent examples for Azure CLI (e.g., az deployment group create).
- In sections referencing deployment commands, include both PowerShell and Azure CLI examples, or clarify that the behavior applies to both.
- When listing connection methods for VMs, alternate or balance the order of Windows and Linux examples, and provide parity in the number of links for each platform.
- Add examples or references for Linux-native tools and workflows, such as Bash scripting or Azure CLI usage, alongside PowerShell examples.
- Review the documentation for other subtle Windows-first language or assumptions, and ensure Linux users are equally addressed.
Create Pull Request