Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias in several ways. PowerShell is consistently presented as the primary scripting example, often before or in addition to Azure CLI. Examples of VM images and scripts use Windows-centric publishers, offers, and file types (e.g., .ps1 PowerShell scripts, MicrosoftWindowsServer images). There are no Linux-specific examples, such as Bash scripts, Linux VM images, or Linux VM extensions. Windows tools and patterns (PowerShell DSC, CustomScriptExtension for Windows, .ps1 scripts) are referenced exclusively or before their Linux equivalents.
Recommendations
- Provide Linux/Bash equivalents for all PowerShell script examples, especially for verifying template functions and resource providers.
- Include examples using Linux VM images (e.g., Ubuntu, CentOS) alongside WindowsServer in ARM template snippets.
- Show how to use CustomScriptExtension for Linux, referencing .sh scripts, and demonstrate parameterization for Linux artifacts.
- List and demonstrate Linux VM extensions and their availability in Azure Stack, not just Windows extensions.
- Balance the order of CLI and PowerShell examples, or present CLI first for cross-platform parity.
- Reference Linux-friendly tools and workflows (e.g., VS Code on Linux, Bash automation) in testing and automation sections.
- Avoid defaulting artifact locations and examples to Windows-centric repositories; provide parallel Linux-focused samples.
Create Pull Request