Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page exhibits Windows bias in several ways: Windows-specific terminology and examples (e.g., 'osType': 'Windows', PowerShell commands) are presented before or instead of Linux equivalents. PowerShell is given its own section with detailed notes, while Linux shell examples are minimal and lack parity in explanation. There are no explicit Linux-specific examples (e.g., using --os-type Linux or Linux disk images), and the CLI examples default to Windows settings. The documentation does not mention Linux-specific patterns or tools, and the sample requests/responses use Windows as the default operating system.
Recommendations
- Include explicit Linux examples in REST API, Azure CLI, and PowerShell sections (e.g., using 'osType': 'Linux', Linux disk images, and Linux-specific parameters).
- Provide parity in command explanations for Bash/shell and PowerShell, including multiline command notes for Bash.
- Avoid defaulting to Windows in sample requests and responses; alternate or show both Windows and Linux cases.
- Mention Linux-specific considerations, such as supported file formats, disk types, and security profiles relevant to Linux VMs.
- Ensure that CLI examples use variables and flags that are applicable to both Windows and Linux, or show separate examples for each.
Create Pull Request