About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a mild Windows bias. While it claims that Azure CLI command examples can run in both PowerShell and bash, the only explicit command example is given in a generic CLI format without showing both PowerShell and bash syntax where they might differ. There is mention that separate examples are provided 'where needed,' but no Linux-specific (bash) example is actually shown. The documentation also references running CLI commands in PowerShell first, and the prerequisite section for Azure CLI setup is ambiguous about Linux-specific steps or differences.
Recommendations:
- Provide explicit bash/Linux command examples alongside PowerShell examples wherever variable syntax or command usage differs.
- Ensure that CLI setup instructions include Linux-specific prerequisites and installation steps, not just generic or Windows-focused guidance.
- If referencing the ability to use both PowerShell and bash, demonstrate this parity by including both sets of examples where relevant.
- Avoid language that defaults to Windows-first (e.g., mentioning PowerShell before bash), or alternate the order to show neutrality.
- Include troubleshooting or environment notes for Linux users, such as common issues with Azure CLI on Linux.
Create pull request