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 Bicep and ARM templates, and covers Linux-specific hosting plans (including Flex Consumption, Container Apps, and Azure Arc). However, there is a consistent pattern of presenting Windows examples before Linux ones ("windows_first"), especially in code tabs and explanations. Additionally, PowerShell is the only scripting language shown for command-line deployment automation, with no Bash or Linux shell equivalents ("powershell_heavy"). There are no exclusive references to Windows-only tools, but the ordering and scripting language choices may subtly prioritize Windows users.
Recommendations:
- Alternate the order of Windows and Linux examples/tabs, or default to Linux first in some sections, especially for plans that are Linux-only.
- Provide Bash/Azure CLI shell script equivalents for all PowerShell deployment examples, especially in the 'Deploy your template' section.
- Where possible, clarify when a feature or example is Windows- or Linux-specific, and ensure parity in depth and detail for both platforms.
- Highlight cross-platform tools (like Azure CLI) more prominently, and avoid implying PowerShell is the default for all users.
- In summary tables and introductory text, avoid listing Windows before Linux by default—consider alphabetical or usage-based ordering.
Create pull request