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:
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation exhibits several signs of Windows bias. PowerShell is the only example given for service principal setup, with no Azure CLI or Bash equivalent. Windows tools (e.g., PuTTY) are mentioned prominently as SSH clients, and Windows port (RDP 3389) is listed before Linux (SSH 22) in inbound port selection. The documentation refers to Windows connection instructions first and provides more detailed steps for Windows tools, while Linux instructions are less detailed and lack native SSH/Bash command examples.
Recommendations:
- Provide Azure CLI and/or Bash equivalents for all PowerShell commands, especially for service principal and key creation steps.
- Mention native SSH clients (e.g., OpenSSH) before or alongside PuTTY, and provide command-line SSH examples for Linux/macOS users.
- List Linux ports (SSH 22) before Windows ports (RDP 3389) or present both equally.
- Ensure that connection instructions for Linux VMs include native SSH command-line examples, not just PuTTY.
- Wherever Windows-specific tools or patterns are mentioned, ensure Linux equivalents are also referenced with equal prominence.
- Add explicit Linux/Bash/CLI examples for all steps that currently only show PowerShell or Windows-centric instructions.
Create pull request