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
Summary:
The documentation presents deployment instructions with PowerShell examples before Azure CLI, which can be interpreted as a 'Windows-first' approach. The use of PowerShell as the first tab and the mention of 'Azure PowerShell' before 'Azure Command-Line Interface (CLI)' in the prerequisites further reinforce a Windows-centric bias. However, Azure CLI is also provided, which is cross-platform, and there are no exclusive references to Windows-only tools or missing Linux examples.
Recommendations:
- Alternate the order of PowerShell and Azure CLI examples across documentation pages, or default to Azure CLI first, as it is cross-platform and more familiar to Linux/macOS users.
- In the prerequisites, mention Azure CLI before Azure PowerShell, or present them together without preference.
- Explicitly state that both Azure CLI and PowerShell are available on all major platforms, and provide links to installation instructions for Linux/macOS users.
- Where possible, include screenshots or instructions for verifying deployments using Azure CLI (e.g., 'az resource show') in addition to the Azure portal.
- Ensure that none of the instructions assume a Windows environment (e.g., use of backslashes in file paths, PowerShell-specific syntax) unless clearly noted.
Create pull request