Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides examples for Azure CLI, Azure PowerShell, and Azure Portal, but does not include any Linux-specific shell examples (such as Bash or scripting patterns), nor does it mention Linux tools or workflows. Azure PowerShell, which is traditionally Windows-centric, is given equal prominence to Azure CLI, and in some cases, PowerShell examples appear before CLI examples. There is no discussion of platform-specific considerations, nor any explicit guidance for Linux users beyond the CLI, which is cross-platform but not always used in the same way on Linux.
Recommendations
- Add explicit Bash shell examples and scripting patterns for Linux users, especially for multi-step workflows.
- Clarify that Azure CLI commands work cross-platform and provide notes on any platform-specific differences (e.g., quoting, environment variables, file paths).
- Consider reordering examples to present Azure CLI (the most cross-platform tool) before PowerShell, or explicitly state platform parity.
- Include troubleshooting tips or links for Linux users, such as common issues with Azure CLI on Linux.
- If PowerShell is mentioned, clarify that PowerShell Core is available on Linux and provide installation guidance or links.
- Avoid assuming PowerShell is the default for scripting; highlight Bash and other Linux-native options where appropriate.