Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates significant Windows bias by providing only PowerShell-based examples and instructions, which are specific to Windows environments. There are no CLI, Bash, or Linux/macOS shell examples, nor are Linux-specific considerations or patterns mentioned. The workflow and tooling described (e.g., PowerShell cmdlets, RDP) are Windows-centric, making it difficult for Linux users to follow or adapt the instructions.
Recommendations
- Add equivalent examples using Azure CLI (az) commands, which are cross-platform and work on Linux/macOS.
- Include Bash shell script snippets for common operations (disk, network, VM creation) alongside PowerShell.
- Explicitly mention Linux VM scenarios, including SSH access setup and Linux-specific disk attachment considerations.
- Reorganize the documentation to present cross-platform (CLI) instructions first, or side-by-side with PowerShell.
- Clarify which steps are universal and which are Windows-specific, especially regarding OS disk attachment and network rules.
Create Pull Request