Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by consistently providing PowerShell examples before or alongside Azure CLI, referencing Windows-specific tools and patterns (such as PowerShell DSC and .ps1 scripts), and using Windows-centric terminology and artifacts (e.g., 'dotnet-core-music-windows', 'MicrosoftWindowsServer' images). There is a lack of Linux-specific examples, such as Bash scripts or Linux VM images, and Linux VM extension scenarios are not covered. The documentation assumes familiarity with Windows tooling and does not offer parity for Linux users.
Recommendations
- Provide Linux/Bash equivalents for all PowerShell examples, especially for template function verification and resource provider queries.
- Include examples using Linux VM images (e.g., Ubuntu, CentOS) and reference Linux publishers/offers/SKUs in template snippets.
- Demonstrate VM extensions for Linux (e.g., Custom Script for Linux, OMSAgent) and show how to link to .sh scripts as artifacts.
- Balance references to Windows tools (PowerShell, DSC) with Linux alternatives (Bash, cloud-init, Ansible).
- Ensure that documentation sections mentioning Windows-specific patterns (such as .ps1 scripts) also mention or show Linux equivalents (.sh scripts).
- Add notes or guidance for Linux users where tooling or workflow differs, including IDE recommendations and testing approaches.
Create Pull Request