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
⚠️
windows_examples_prominence
⚠️
powershell_heavy
Summary:
The documentation generally provides parity between Windows and Linux for Bicep and ARM template examples, but there is a consistent pattern of presenting Windows examples and instructions before Linux equivalents ("windows_first"). In several sections, Windows tabs are listed first, and Windows-specific settings or instructions are described before Linux. The deployment instructions and validation sections feature PowerShell examples prominently, with less emphasis on Bash or cross-platform CLI alternatives ("powershell_heavy"). There are no outright missing Linux examples, but the ordering and prominence favor Windows.
Recommendations:
- Alternate the order of Windows and Linux examples/tabs, or present Linux first in some sections to balance prominence.
- Where possible, provide Bash/Azure CLI examples alongside PowerShell, especially in deployment and validation sections.
- Explicitly state that all examples are cross-platform unless noted, and highlight any Linux-specific considerations at the same level as Windows.
- Review tab ordering and ensure Linux is not always secondary.
- In sections where Windows and Linux instructions are nearly identical, consider merging them and calling out differences inline, rather than segregating by OS with Windows first.
Create pull request