Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides extensive Azure Portal (GUI) instructions, which are platform-agnostic, followed by Azure CLI examples (Linux/macOS/Windows compatible), and then a full section of PowerShell scripts. However, the PowerShell section is given equal prominence to the CLI, and no explicit mention is made of Bash, Linux-specific tools, or shell scripting. The ordering of examples (Portal, CLI, PowerShell) is typical, but the PowerShell section is detailed and assumes familiarity with Windows-centric tooling, which may disadvantage Linux users. There are no examples using Bash, nor is there guidance for Linux users who may not have access to PowerShell.
Recommendations
- Add explicit Bash script examples alongside Azure CLI, demonstrating Linux-native workflows.
- Clarify that Azure CLI commands work on Linux, macOS, and Windows, and provide shell-specific notes if necessary.
- Consider moving PowerShell examples to a dedicated section labeled 'Windows/PowerShell' to make platform distinctions clear.
- Add notes or links for Linux users on installing and using Azure CLI in their environment.
- If PowerShell is required for advanced scenarios, mention cross-platform PowerShell Core and provide Linux installation instructions.