Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides detailed instructions for relocating an Azure Virtual Network using the Azure Portal and Azure PowerShell. All command-line examples are exclusively PowerShell-based, with no mention of Azure CLI or Bash, which are preferred by many Linux/macOS users. The PowerShell tab appears before any potential CLI or Bash alternatives, and there are no Linux-specific or cross-platform command-line instructions. This creates friction for users on non-Windows platforms who may not have access to PowerShell or prefer native tools.
Recommendations
- Add Azure CLI examples alongside PowerShell for all command-line steps, including exporting, editing, and redeploying templates.
- Explicitly mention that Azure CLI is cross-platform and provide Bash-friendly commands and file editing instructions.
- Ensure that the documentation tabs include 'Azure CLI' and/or 'Bash' options, not just 'Portal' and 'PowerShell'.
- Reference common Linux/macOS editors (e.g., vim, nano) when instructing users to edit JSON files.
- Clarify that PowerShell Core is available on Linux/macOS, but Azure CLI is often more convenient for those platforms.
Create Pull Request