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
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by presenting Azure PowerShell instructions and references before Azure CLI in all relevant sections. PowerShell is a Windows-centric tool, and its precedence in the documentation implies a preference for Windows environments. Additionally, there are no explicit Linux shell (bash) examples, and the CLI output examples use PowerShell cmdlets for status checks, even in the CLI section. The use of PowerShell and the ordering of examples may disadvantage Linux users or those who prefer cross-platform tooling.
Recommendations:
- Alternate the order of PowerShell and CLI instructions, or present CLI (which is cross-platform) first to improve parity.
- In CLI sections, use only CLI commands for all steps, including status checks (e.g., 'az feature show' instead of 'Get-AzProviderFeature').
- Add explicit bash shell examples where relevant, especially for scripting or automation scenarios.
- Clarify in each section that both PowerShell and CLI are supported on Windows, Linux, and macOS, and provide links to installation guides for both.
- Avoid using PowerShell-specific output or terminology in CLI sections to prevent confusion for Linux users.
Create pull request