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_tools
⚠️
powershell_heavy
Summary:
The documentation demonstrates a mild Windows bias. The first VM creation example uses a Windows image, and only afterward is a Linux (Ubuntu) example shown. Artifact examples and sample outputs reference both Windows and Linux, but Windows artifacts (e.g., windows-7zip) are highlighted in output. The section on listing artifacts gives PowerShell/Windows Cloud Shell instructions before Bash/Linux, and the PowerShell-specific escaping is explained first. There is no explicit omission of Linux examples, but Windows is often presented first or more prominently.
Recommendations:
- Alternate the order of Windows and Linux examples, or provide Linux examples first in some sections.
- Include more Linux-specific artifact examples and outputs, not just Windows ones.
- Present Bash/Linux Cloud Shell instructions before PowerShell/Windows, or show both side-by-side.
- Ensure that references to connecting to VMs (SSH vs RDP) are balanced and that Linux connection methods are not secondary.
- Where possible, use neutral or parallel examples (e.g., show both a Windows and a Linux VM creation command together).
Create pull request