Document Details
Onboard To Azure Arc With Azure Migrate
❌
This page contains Windows bias
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 frequently mentioning Windows-specific tools (such as WinRM and PowerShell) before their Linux equivalents, providing detailed instructions for Windows (e.g., running 'winrm qc'), and referencing Windows authentication and permissions patterns. Linux instructions are present but are often less detailed, and Linux-specific tools or commands are not equally emphasized. There are also references to adding IPs to WinRM TrustedHosts and using PowerShell for service principal creation, with no equivalent Linux command-line examples. Linux authentication methods are mentioned but not demonstrated with examples.
Recommendations:
- Provide Linux command-line examples (e.g., using SSH or shell commands) wherever Windows/PowerShell commands are given.
- When referencing prerequisites or steps, alternate the order or provide parallel instructions for Windows and Linux, rather than listing Windows first.
- Include Linux-specific troubleshooting steps and error codes, not just Windows/WinRM-centric ones.
- Where PowerShell or WinRM is referenced, add equivalent Linux commands or clarify the Linux process (e.g., how to enable SSH, how to check root permissions).
- For service principal creation, include Azure CLI examples for Linux alongside PowerShell/portal instructions.
- Clarify any differences in agent installation or onboarding process between Windows and Linux, and provide explicit steps for both.
Create pull request