Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Windows First
Summary
The documentation is heavily focused on Azure PowerShell scripts and cmdlets for all migration steps, with no mention of Azure CLI, Bash, or cross-platform alternatives. All code examples, installation instructions, and operational guidance assume the use of PowerShell, which is traditionally associated with Windows environments. There is no guidance for Linux/macOS users, and no CLI or REST API equivalents are provided. This creates friction for users on non-Windows platforms and may prevent them from easily completing the migration.
Recommendations
- Provide equivalent Azure CLI (az) commands and scripts for all major migration steps, including configuration cloning and public IP retention.
- Explicitly state whether the provided PowerShell scripts are compatible with PowerShell Core on Linux/macOS, and provide installation/setup instructions for those platforms.
- Include Bash or shell script examples where possible, or at least reference how Linux/macOS users can perform the same tasks.
- Add a section or callout for Linux/macOS users, summarizing their options and any platform-specific caveats.
- If certain steps are only possible with PowerShell, clarify this and provide guidance on using Azure Cloud Shell (which is cross-platform) as an alternative.