Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates Windows bias in several ways: Windows and PowerShell examples are provided and emphasized, with explicit instructions and notes about PowerShell syntax. The REST and CLI examples use 'osType: Windows' and Windows-centric parameters, while Linux-specific examples or references are missing. There are no explicit Linux shell or Linux VM creation examples, and the CLI and REST examples default to Windows settings. PowerShell is given its own section and detailed notes, while Linux command-line patterns (e.g., bash scripting, Linux-specific flags) are not covered.
Recommendations
- Add explicit Linux VM examples, including 'osType: Linux' in REST and CLI samples.
- Provide bash shell examples alongside PowerShell, especially for Azure CLI usage.
- Include notes or sections on Linux command-line conventions (e.g., line continuation, environment variables).
- Ensure parity in documentation for Linux and Windows, such as troubleshooting, FAQ, and tool usage.
- Avoid defaulting to Windows-centric parameters in generic examples; alternate or show both OS types.
Create Pull Request