Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples for Azure Portal, PowerShell, Azure CLI, and REST API. PowerShell is given equal prominence to Azure CLI, but PowerShell is a Windows-centric tool, and its examples are presented before Azure CLI in every section. There are no explicit Linux shell (bash) examples, nor is there mention of Linux-specific tooling or patterns. The documentation assumes PowerShell usage is as common as CLI, which may not reflect the reality for Linux users.
Recommendations
- Add bash shell examples for Azure CLI commands, showing typical Linux usage (e.g., piping, jq for JSON parsing).
- Clarify that PowerShell examples are primarily for Windows users, and Azure CLI examples are cross-platform.
- Consider presenting Azure CLI examples before PowerShell, as CLI is more universally available across platforms.
- Mention that Azure CLI can be used natively on Linux/macOS, and provide links to installation instructions for non-Windows platforms.
- If PowerShell Core (cross-platform) is supported, clarify its usage and differences from Windows PowerShell.
- Avoid implying parity between PowerShell and CLI unless both are equally supported and documented for all platforms.
Create Pull Request