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
⚠️
windows_tools
Summary:
The documentation page demonstrates several forms of Windows bias. In the 'Check cluster connectivity' step, the only example for deploying a test VM uses a Windows 10 image, with RDP as the default access method, and requires a Windows license. The instructions for testing SSH access begin from a Windows command prompt, with no mention of Linux or cross-platform alternatives. In the cluster deployment section, the PowerShell example is mentioned before the Azure CLI example, and there are no explicit Linux shell or Bash examples. Throughout the page, tooling and workflows are described primarily in terms of the Azure portal and Windows-centric patterns, with no guidance for Linux users or those using non-Windows environments.
Recommendations:
- Provide parallel Linux-based examples for deploying a test VM (e.g., Ubuntu or CentOS), including SSH access instructions from a Linux terminal.
- When referencing command-line tools, present Azure CLI (cross-platform) examples before or alongside PowerShell, and include Bash syntax where appropriate.
- In connectivity testing, show how to use SSH from both Windows (e.g., PowerShell or CMD) and Linux/macOS terminals.
- When describing VM deployment, offer both Windows and Linux image options, and clarify that either can be used for testing connectivity.
- Review all step-by-step instructions to ensure Linux users are not excluded or forced to adapt Windows-specific steps.
- Where GUI instructions are given (e.g., Azure portal), consider adding CLI alternatives for automation and scripting, which are platform-agnostic.
Create pull request