Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a strong Windows bias. All command-line examples for creating the prerequisite VM use PowerShell, with no mention of Bash or Azure CLI alternatives. The resource group and VM names (SimpleWinVmResourceGroup, myVM1) and referenced documentation (Windows username/password requirements) reinforce a Windows-centric approach. There are no Linux VM creation examples, nor is there guidance for users who prefer Bash or Linux tools in Cloud Shell. The documentation mentions Azure CLI as a deployment option, but does not provide CLI examples or parity in the quickstart steps.
Recommendations
- Add equivalent Azure CLI and Bash examples for VM and resource group creation, especially for users accessing Cloud Shell from Linux or macOS.
- Include instructions for creating a Linux VM (e.g., Ubuntu) alongside the Windows VM example, with appropriate username/password requirements links.
- Use more neutral resource group and VM names (e.g., 'SimpleVmResourceGroup', 'myVM1') to avoid implying Windows-only usage.
- Present both PowerShell and CLI/Bash options side-by-side, or allow users to select their preferred shell in the documentation.
- Reference both Windows and Linux documentation for username/password requirements when creating VMs.
Create Pull Request