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 generally provides both Windows and Linux examples for ARM/Bicep templates and application settings, often using tabbed sections. However, in several key sections, Windows examples are presented before Linux equivalents ("windows_first"), and PowerShell is the only scripting language shown for deployment automation ("powershell_heavy"). There are no CLI or Bash examples for Linux users in the deployment automation section. The documentation does not appear to omit Linux-specific information or tools, but the ordering and scripting language choices may give the impression of a Windows-centric approach.
Recommendations:
- Alternate the order of Windows and Linux examples in tabbed sections, or default to the user's platform when possible.
- Provide equivalent Azure CLI/Bash examples alongside PowerShell for deployment automation, especially in the 'Deploy your template' section.
- In sections where both Windows and Linux are supported, clarify that both platforms are equally supported and highlight any differences up front.
- Where possible, use cross-platform language (e.g., 'Azure CLI' instead of 'PowerShell') as the primary example, or provide both.
- Ensure that all references to tools, commands, and scripts are available and demonstrated for both Windows and Linux environments.
Create pull request