Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows-first bias by providing only Windows-based examples for specifying images (e.g., 'cycle.image.win2022', 'MicrosoftWindowsServer:WindowsServer:2022-datacenter-g2:latest', 'Windows 2022 DataCenter'). No Linux-based examples are shown in the configuration snippets, despite Linux images being supported and listed in the table. This may lead Linux users to feel less supported or unsure about the correct syntax for their use case.
Recommendations
- Add Linux-based examples alongside Windows examples in all configuration snippets. For example, show how to specify an Ubuntu or CentOS image using ImageName, URN, and Image label.
- Alternate the order of examples or provide both Windows and Linux examples together to avoid the impression of Windows being the default or preferred platform.
- Explicitly mention that the same configuration patterns apply to Linux images, and provide at least one full Linux example for each method of specifying images.
- If possible, include a note or section highlighting Linux-specific considerations or best practices, to ensure parity and inclusivity.
Create Pull Request