Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides examples for Azure Portal, Azure CLI, and Azure PowerShell. While Azure CLI commands are cross-platform, PowerShell examples are given equal prominence and detail, which may favor Windows users. The PowerShell section is extensive and assumes familiarity with Windows-centric tooling, while no Linux/macOS-specific shell examples (e.g., Bash, zsh) are provided. The ordering of tabs places Azure Portal first (neutral), but PowerShell is given as a primary method alongside CLI, which can be seen as Windows-first. There are no explicit Linux/macOS-only instructions, nor are there references to Linux-specific patterns or troubleshooting.
Recommendations
- Clarify that Azure CLI commands work natively on Linux/macOS and Windows.
- Add explicit Bash/zsh shell examples for querying and variable assignment, especially for steps like extracting subnet IDs.
- Note that PowerShell Core is available cross-platform, but provide Bash alternatives for Linux/macOS users.
- Consider reordering tabs or adding a note that CLI is the most cross-platform method.
- Include troubleshooting notes for common Linux/macOS issues (e.g., permissions, environment variables).