Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides Azure portal instructions (which are cross-platform), Azure PowerShell examples, and Azure CLI examples. However, the PowerShell section appears before the CLI section, and PowerShell is a Windows-centric tool (though available on Linux/macOS). There are no Linux/macOS-specific shell examples (e.g., Bash), but the CLI examples are cross-platform. The portal instructions are also platform-agnostic. There is a minor bias in presenting PowerShell before CLI, which may imply Windows-first thinking, but Linux users can complete all tasks using Azure CLI or portal.
Recommendations
- Present Azure CLI examples before PowerShell examples, as CLI is more universally available across platforms.
- Explicitly note that Azure CLI commands work on Linux, macOS, and Windows, and PowerShell is available cross-platform but is more familiar to Windows users.
- Consider adding Bash script examples for common tasks, or clarify that Azure CLI commands can be run in Bash or other shells.
- Add a short statement at the start of scripting sections indicating that both CLI and PowerShell are supported on all major OSes, but CLI is typically preferred for Linux/macOS users.