Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page, while focused on Linux VMs, relies heavily on PowerShell-based workflows and examples for the migration process. The main migration script is a PowerShell script, and most step-by-step instructions (checking controller type, preparing environment, running the script, reverting changes, checking results) are given using PowerShell commands. There is minimal coverage of Linux-native tooling or shell scripting, and the use of PowerShell is presented as the default, even for Linux users. Azure CLI is mentioned briefly, but not as a primary workflow. Windows-centric tools and patterns (e.g., Set-ExecutionPolicy, PowerShell installation, Windows-style paths) are referenced before any Linux alternatives.
Recommendations
- Provide equivalent Bash/shell script workflows for Linux users, including migration, verification, and rollback steps.
- Offer Azure CLI-based examples for all major tasks, especially for checking VM properties and running migration scripts.
- Document how to run the migration script natively on Linux (e.g., via Azure Cloud Shell, or using pwsh on Linux), and clarify prerequisites for Linux environments.
- Reorder examples so that Linux-native commands and workflows are shown first or in parallel with PowerShell/Windows examples.
- Explicitly note any limitations or differences when running the migration process on Linux vs. Windows.
Create Pull Request