Document Details
Quickstart Developer
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits a mild Windows bias. While it mentions both Windows and Linux VMs in prerequisites, Windows is consistently listed first (e.g., port 3389 before 22, 'Quickstart: Create a Windows VM' before Linux). Keyboard shortcut examples are only provided for Windows VMs, with no equivalent guidance for Linux desktop environments. There are no Linux-specific connection or troubleshooting examples, and the only keyboard shortcuts discussed are for Windows. There is also an implicit assumption of familiarity with Windows tools and patterns.
Recommendations
- Alternate the order of Windows and Linux references (e.g., sometimes list Linux first).
- Provide Linux desktop environment shortcut examples (e.g., how to send Ctrl+Alt+Del or open a terminal in GNOME/KDE via Bastion).
- Include screenshots or notes about connecting to Linux VMs and what users should expect (e.g., SSH session, desktop environment).
- Add troubleshooting tips or notes for Linux users (e.g., handling clipboard, keyboard mapping issues in Linux sessions).
- Ensure parity in example links and documentation coverage for both Windows and Linux VM scenarios.
Create Pull Request
Clean