Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Windows First
Summary
The documentation page is heavily biased toward Windows and PowerShell environments. All migration scripts, examples, and installation instructions are provided exclusively for Azure PowerShell (.ps1) scripts, with no mention of Bash, Azure CLI, or Linux/macOS-specific alternatives. The guidance assumes the user is running PowerShell locally or in Azure Cloud Shell, and all code samples use PowerShell cmdlets. There are no Linux or macOS shell examples, nor any references to cross-platform scripting or CLI equivalents. This creates friction for users on Linux or macOS who may prefer or require Bash/Azure CLI workflows.
Recommendations
- Provide equivalent Azure CLI (az) commands and scripts for all migration steps, including configuration and traffic migration.
- Include Bash shell examples for script invocation and parameter passing.
- Explicitly document how Linux/macOS users can run the migration scripts (e.g., via Azure Cloud Shell, PowerShell Core, or alternative methods).
- Add a section clarifying cross-platform support and limitations, and recommend best practices for non-Windows environments.
- If PowerShell is required, provide instructions for installing and running PowerShell Core on Linux/macOS, or highlight Azure Cloud Shell as a platform-neutral option.