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:
⚠️
powershell_heavy
⚠️
windows_first
Summary:
The documentation presents both Azure PowerShell and Azure CLI examples, but the PowerShell section is listed first and is more detailed, with step-by-step explanations and variable usage. The CLI section is less detailed and lacks some of the explanatory context provided in the PowerShell section. There are no Linux-specific shell examples or explicit mention of Linux environments, and the documentation implicitly assumes familiarity with PowerShell, which is more common on Windows.
Recommendations:
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to avoid implicit Windows-first bias.
- Ensure both PowerShell and CLI sections have equivalent detail and explanation, including variable usage and step-by-step breakdowns.
- Explicitly mention that Azure CLI commands can be run natively on Linux, macOS, and Windows, and provide bash/zsh syntax where appropriate.
- Consider adding a short section or note for Linux users, clarifying that all CLI commands are cross-platform and providing any Linux-specific tips if relevant.
- If possible, provide examples using Azure REST API or ARM templates, which are platform-agnostic, to further enhance cross-platform parity.
Create pull request