Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Windows First
Summary
The documentation page is heavily biased towards Windows and PowerShell usage. All migration scripts, examples, and instructions are provided exclusively in PowerShell, with no mention of Bash, Azure CLI, or Linux-native tooling. The installation and execution steps assume a Windows/PowerShell environment, and references to script downloads and module management are specific to PowerShell Gallery and Windows conventions. There are no Linux or cross-platform alternatives, nor any guidance for users who may be working in a Linux shell or prefer Azure CLI. This creates a significant barrier for Linux users and those working in non-Windows environments.
Recommendations
- Provide equivalent Azure CLI (az) commands and scripts for all migration operations, including configuration cloning and public IP retention.
- Include Bash shell examples for script execution and parameter handling, especially for certificate management and file operations.
- Document how to use Azure Cloud Shell in Bash mode, and clarify that all operations can be performed from Linux/macOS terminals.
- Offer downloadable scripts in a cross-platform format (e.g., Python, shell scripts) or clarify PowerShell Core compatibility on Linux/macOS.
- Add a section explicitly addressing Linux/macOS users, outlining any prerequisites, installation steps, and differences in workflow.
- Ensure that references to PowerShell Gallery are supplemented with instructions for Linux users (e.g., using pwsh, or alternative package managers).
- Where possible, present Azure CLI examples before or alongside PowerShell examples to avoid 'windows_first' bias.