Bias Analysis
Detected Bias Types
windows_first
windows_tools
missing_linux_example
powershell_heavy
Summary
The documentation page exhibits several signs of Windows bias. Examples and code snippets consistently use Windows-centric images (e.g., 'MicrosoftWindowsServer'), and the ARM template quickstart links to a Windows-specific template. PowerShell instructions are detailed and prominent, while Linux-specific examples (such as using Ubuntu or other Linux images) are absent from all code samples. The extension publisher table mentions Linux, but no Linux image or command-line examples are provided. The documentation assumes familiarity with Windows tooling and patterns, and Windows is prioritized in examples and references.
Recommendations
- Add explicit Linux examples (e.g., using Ubuntu or Red Hat images) in ARM template, CLI, and PowerShell sections.
- Provide sample code snippets for Linux image references alongside Windows examples.
- Link to both Windows and Linux quickstart ARM templates.
- Clarify any differences or requirements for Linux Trusted launch enablement (e.g., Secure Boot, vTPM support).
- Ensure extension publisher examples show both Windows and Linux usage.
- Balance PowerShell and CLI instructions, and mention cross-platform alternatives where possible.
Create Pull Request