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
Summary:
The documentation exhibits some Windows bias, particularly in the use of PowerShell for prerequisite steps (service principal creation), the mention of Windows-specific tools (PuTTY) as the primary SSH client example, and the ordering of Windows connection instructions before Linux. Linux alternatives are present but often secondary or less detailed.
Recommendations:
- Provide Azure CLI and/or Bash equivalents for all PowerShell commands, especially for service principal and key creation steps.
- When referencing SSH clients, mention native OpenSSH (available by default on most Linux/macOS systems) before or alongside PuTTY, and clarify that PuTTY is primarily needed on Windows.
- In connection instructions, present Linux and Windows methods in parallel or in a neutral order, rather than listing Windows first.
- Ensure that all steps and examples are provided for both Windows and Linux users, with equal detail and prominence.
- Where possible, link to both Windows and Linux documentation for further actions (e.g., connecting, key creation) rather than only one.
Create pull request