Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Windows First
Summary
The documentation provides parity between Azure Portal, Azure CLI, and Azure PowerShell for most tasks. However, there is a notable bias toward PowerShell, especially in critical steps such as enabling IPv6 on zone-redundant gateways, where only PowerShell commands are provided and users are explicitly told to use PowerShell due to portal limitations. This assumes access to PowerShell, which is a Windows-centric tool, although it is available on Linux/macOS. Additionally, PowerShell examples and references are frequent, and in some sections, PowerShell is mentioned before CLI. There are no Linux/macOS-specific instructions or troubleshooting notes, and the documentation does not acknowledge differences in PowerShell usage across platforms.
Recommendations
- Provide explicit Azure CLI alternatives for all PowerShell-only steps, especially where users are told to use PowerShell due to portal limitations.
- Clarify that PowerShell Core is available cross-platform and provide installation guidance for Linux/macOS users.
- Ensure that CLI examples are given equal prominence and are not secondary to PowerShell, especially in critical workflow steps.
- Add troubleshooting notes or links for Linux/macOS users who may encounter issues running PowerShell scripts.
- Consider adding bash or shell script examples for common tasks, or at least acknowledge their use.