Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides parity for both Linux and Windows VMs at a high level, but there is a notable bias toward Windows tools and patterns. PowerShell is heavily featured in both the main and template sections, and Windows-specific tools (RDP, PowerShell) are mentioned before their Linux equivalents (SSH, CLI). The CLI examples are cross-platform, but PowerShell is Windows-centric. In several places, PowerShell is presented as the default scripting option, and instructions for tasks like deallocation and template deployment use PowerShell syntax, with no Bash or Linux shell alternatives. The documentation also references Windows tools (RDP, PowerShell) before Linux ones (SSH, CLI) when discussing VM access.
Recommendations
- Provide Bash or Linux shell script examples alongside PowerShell for template deployments and VM operations.
- Explicitly mention that Azure CLI is cross-platform and can be run on Linux/macOS, and provide Linux/macOS installation links.
- When listing access methods, mention SSH (Linux) before or alongside RDP (Windows), or alternate their order.
- Where PowerShell is used for template deployment, provide equivalent Bash/CLI commands for Linux/macOS users.
- Clarify that all steps can be performed on Linux VMs, and link to Linux-specific troubleshooting or validation guides.
Create Pull Request