Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits several signs of Windows bias. Windows-specific tools and patterns (such as PowerShell scripts and references to Windows authentication) are mentioned before or more prominently than Linux equivalents. The option to set up the Azure Migrate appliance using a PowerShell script on Windows Server is highlighted, while no analogous Linux-based setup method is described. Examples and instructions for credential provisioning and server access are more detailed for Windows (domain, non-domain, PowerShell, Active Directory) than for Linux (SSH key-based), and some features (such as SQL Server and IIS web app discovery) are described only in the context of Windows. Linux instructions are present but less detailed, and there are no Linux-first or Linux-only setup examples.
Recommendations
- Provide explicit instructions and examples for setting up the Azure Migrate appliance on Linux servers, including a Linux-based installation method analogous to the PowerShell script for Windows.
- Ensure that Linux credential provisioning (SSH key, password-based) is described with equal detail and step-by-step guidance as Windows credential provisioning.
- Include Linux-first examples and screenshots where appropriate, such as using Linux tools to validate connectivity, configure the appliance, or troubleshoot issues.
- Mention Linux tools and patterns (such as shell scripts, systemd services, or Linux package managers) alongside or before Windows tools when describing appliance setup and management.
- Expand documentation for discovery and assessment of Linux-specific workloads and applications, not just SQL Server and IIS web apps.
- Clarify any feature parity or limitations for Linux servers, and provide guidance for Linux administrators to achieve equivalent outcomes.
Create Pull Request