Detected Bias Types
Powershell Heavy
Missing Linux Example
🔧
Windows Tools
Windows First
Summary
The documentation for migrating Azure Application Gateway from V1 to V2 is heavily focused on PowerShell-based scripts and workflows, with all examples, instructions, and tooling centered around Azure PowerShell. There are no Bash, Azure CLI, or Linux/macOS-specific instructions or examples provided. The installation and usage patterns (e.g., Install-Script, .ps1 files, PowerShell Gallery) are Windows-centric and may create friction for users on Linux or macOS platforms, who typically use Bash and Azure CLI. The documentation does not mention or provide alternatives for non-Windows environments, nor does it clarify cross-platform compatibility of the provided scripts.
Recommendations
- Explicitly state whether the PowerShell scripts are cross-platform and can be run on PowerShell Core on Linux/macOS.
- Provide Azure CLI equivalents for key migration steps, or clarify if such automation is not available.
- Add Bash shell examples for common operations (e.g., retrieving resource IDs, uploading certificates) using Azure CLI.
- Include installation and usage instructions for PowerShell on Linux/macOS, or link to official guidance.
- Mention and link to Azure Cloud Shell as a cross-platform alternative for running PowerShell scripts.
- Add a section addressing Linux/macOS users, outlining any limitations or required adaptations.