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
⚠️
missing_linux_example
Summary:
The documentation exhibits a Windows-first bias, particularly in the 'Prepare on-premises to connect after failover' section, where Windows VM instructions are more detailed and appear before Linux instructions. Windows-specific tools and settings (e.g., Windows Firewall, RDP, WinHTTP proxy, SAN policy) are mentioned, while Linux instructions are brief and lack equivalent detail. There are also missing Linux-specific troubleshooting steps and configuration examples compared to the Windows sections.
Recommendations:
- Provide Linux instructions with equal detail and prominence as Windows instructions, including firewall configuration (e.g., iptables, firewalld, ufw), SSH service management, and handling of static routes or proxies on Linux.
- Include Linux-specific troubleshooting steps for post-failover connectivity, similar to the linked Windows RDP troubleshooting guide.
- Present Windows and Linux instructions in parallel or side-by-side tables to avoid the perception of prioritizing one platform over the other.
- Mention Linux equivalents for Windows-specific terms (e.g., explain how to check for pending updates or SAN policy equivalents on Linux, if relevant).
- Ensure that automation and scripting examples (if any) are provided for both PowerShell (Windows) and Bash/Shell (Linux) environments.
Create pull request