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
Bias Types:
⚠️
windows_first
⚠️
windows_tools
⚠️
powershell_heavy
Summary:
The documentation demonstrates a mild Windows bias. Windows VMs and tools are mentioned first in several places, such as in the prerequisites (port 3389 for Windows is listed before port 22 for Linux), and the example links for creating VMs list Windows before Linux. Keyboard shortcut guidance is focused on Windows VMs, with only a brief mention of Mac clients connecting to Windows VMs. There are no explicit Linux command-line or desktop usage examples, and the guidance for connecting and using the Bastion service is written with Windows-centric terminology and scenarios.
Recommendations:
- Alternate the order of Windows and Linux references throughout the documentation to avoid always listing Windows first.
- Provide explicit Linux desktop and keyboard shortcut examples, especially for remote desktop scenarios (e.g., how to send Ctrl+Alt+Del to a Linux VM, or common Linux desktop shortcuts).
- Include screenshots or walkthroughs for both Windows and Linux VMs to ensure parity.
- When referencing ports, clarify that 3389 is for Windows (RDP) and 22 is for Linux (SSH), and consider listing them in varying order or together.
- Add a section or callout for connecting to Linux VMs, including any differences in authentication, desktop environments, or troubleshooting.
- Ensure that all instructions and terminology are equally applicable to both Windows and Linux users.
Create pull request