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
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows-first bias by presenting the Windows RDP connection method before the Linux SSH method, and by providing a detailed, step-by-step instruction for Windows users (including a pre-configured RDP file download), while Linux users are only given a brief description without a concrete SSH command example. There is also a lack of parity in actionable examples for Linux users.
Recommendations:
- Present Windows and Linux instructions in parallel, or alternate which is presented first.
- Provide explicit SSH command-line examples for Linux users (e.g., ssh username@contoso.westus3.cloudapp.azure.com -p 65013).
- Include screenshots or step-by-step instructions for Linux SSH connections, similar to the RDP instructions for Windows.
- Avoid assuming the user is on Windows; mention cross-platform tools where possible.
- Clarify that SSH can be used from Windows, macOS, or Linux, and provide guidance for each.
Create pull request