Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a strong Windows bias. All scripting and automation examples use Azure PowerShell, with no mention of Bash, Azure CLI, or Linux scripting alternatives. The sample configuration references only Windows images (e.g., Win2012R2, Win2016), and there are no examples or guidance for Linux VM image creation or distribution. The documentation assumes familiarity with Windows-centric tools and workflows, omitting Linux equivalents.
Recommendations
- Provide parallel examples using Azure CLI and Bash scripts for saving and distributing images, alongside PowerShell.
- Include Linux VM image examples in the labs.json configuration and discuss any differences in generalizing Linux VMs (e.g., using waagent for deprovisioning).
- Mention and illustrate how to add Azure CLI tasks in Azure DevOps build definitions, not just Azure PowerShell.
- Balance the documentation by referencing both Windows and Linux workflows, tools, and image types throughout.
- Add a section or callout for Linux users, highlighting any special considerations or steps.
Create Pull Request