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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows-first bias by consistently listing Windows instructions and tools before Linux equivalents, especially in SSH connection steps. Windows-specific tools (e.g., PuTTY, Windows built-in SSH) are highlighted, while Linux and macOS SSH instructions are missing or underexplained. There is also a lack of parity in example commands and tool recommendations for non-Windows users.
Recommendations:
- Provide explicit SSH connection instructions for Linux and macOS users, including example commands and terminal usage.
- List instructions for all platforms (Windows, Linux, macOS) in parallel tables or sections, rather than always leading with Windows.
- Mention native SSH clients on Linux and macOS, and provide guidance for their use.
- Balance tool recommendations by including popular Linux and macOS SSH clients (e.g., Terminal, GNOME Terminal, iTerm2) alongside Windows tools.
- Ensure that all examples and screenshots are platform-agnostic or include variants for each major OS.
Create pull request