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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by providing appliance-side instructions exclusively for Windows environments (e.g., using Remote Desktop, referencing Windows file paths, and using PowerShell commands to restart services). There are no equivalent instructions or examples for Linux-based appliances, nor is there any mention of how to perform these steps on Linux. This may hinder users operating the Azure Migrate appliance on Linux or in mixed environments.
Recommendations:
- Provide equivalent instructions for Linux-based appliances, including file paths (e.g., /etc or /var locations), service management commands (e.g., systemctl or service), and text editors (e.g., nano or vi).
- When referencing remote access, mention SSH or console access for Linux in addition to Remote Desktop for Windows.
- Include both PowerShell and Bash (or shell) command examples for service restarts and file editing.
- Clearly state whether the Azure Migrate appliance is only supported on Windows, or if Linux is supported, and provide parity in documentation.
- Avoid assuming the use of Windows tools and patterns (e.g., %programdata%, PowerShell) as the default; always provide cross-platform alternatives.
Create pull request