Document Details
Infrastructure Automation
This page contains Windows bias
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
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation generally covers both Linux and Windows automation tools, but there are several areas where Windows examples, tools, or instructions are presented before or instead of Linux equivalents. Some sections (Chef, Puppet) provide only or primarily Windows-focused links, and in others (Azure Resource Manager template, Azure Automation) Windows examples are listed before Linux ones. There is also a tendency to mention Windows-specific tools (PowerShell DSC) more prominently, with Linux support as a secondary note.
Recommendations
- Ensure that examples and instructions for Linux are provided alongside Windows, especially for tools like Chef and Puppet.
- Present Linux and Windows examples in parallel or alternate order to avoid implicit prioritization.
- Where Windows-specific tools are discussed (e.g., PowerShell DSC), highlight Linux equivalents (e.g., cloud-init) with equal prominence.
- Add links to Linux-focused documentation for Chef and Puppet, not just Windows install guides.
- Review the ordering of examples and links to avoid listing Windows first by default, especially in sections like Azure Resource Manager template and Azure Automation.
- Explicitly state Linux support and provide Linux-specific instructions for all tools where applicable.
Create Pull Request
Clean