Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by referencing Windows tools and patterns first, such as PowerShell scripts and the BGInfo extension, and by listing Windows extensions before Linux equivalents. The sample deployment scripts are described as 'PowerShell and Azure CLI', with PowerShell mentioned first and no explicit Bash or Linux shell examples provided. The 'ms.collection' metadata is set to 'windows', further reinforcing the bias. Linux-specific instructions, examples, or parity in extension support are not clearly presented.
Recommendations
- Explicitly mention and provide Bash or Linux shell examples for template deployment, alongside PowerShell.
- List Linux and Windows VM extensions in parallel or alphabetically, rather than Windows-first.
- Clarify that Azure CLI is cross-platform and provide Linux/macOS usage notes.
- Update metadata to reflect cross-platform applicability, not just 'windows'.
- Include screenshots or instructions from Linux/macOS perspectives where relevant.
Create Pull Request