Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation frequently presents Windows-based examples first, especially in REST API and PowerShell sections, and provides more detailed PowerShell instructions for Windows than for Linux. While Azure CLI examples are given for Linux, there is a lack of parity in scripting examples (e.g., no Bash or shell script equivalents for Linux users). The troubleshooting and log location sections do mention Linux, but overall, Windows tools and patterns are prioritized or more thoroughly documented.
Recommendations
- Present Linux and Windows examples side-by-side or alternate which comes first in each section.
- Provide Bash or shell script examples for Linux users, especially where PowerShell is used for Windows.
- Expand Linux-specific guidance, such as troubleshooting steps and log analysis, to match the detail given for Windows.
- Explicitly mention Linux/macOS compatibility and any platform-specific caveats in each relevant section.
- Ensure that all REST API and Azure CLI examples clearly indicate how to use them for both Linux and Windows VMs, including the correct 'type' property.
Create Pull Request