Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation shows a moderate Windows bias. PowerShell examples are provided alongside CLI, but references to Windows tools (like Sysprep) and Windows-specific links appear before or more prominently than Linux equivalents. Some sections (e.g., image generalization, uploading VHDs) mention Windows first or link to Windows-specific guides before Linux ones. There are also references to Azure PowerShell and .NET SDK, which are more commonly used on Windows, with less emphasis on cross-platform or Linux-native tooling. Linux examples are present but sometimes secondary.
Recommendations
- Ensure CLI examples are shown before or alongside PowerShell, as Azure CLI is cross-platform.
- When mentioning OS-specific tools (e.g., Sysprep for Windows, waagent for Linux), present both equally and in parallel, not Windows first.
- Provide direct links to Linux documentation and examples wherever Windows links are given.
- Highlight cross-platform SDKs and tools (Python, Go, Node.js) more prominently.
- Add explicit Linux/macOS command-line examples where only PowerShell is shown.
- Review and balance the order of OS references in tables and lists.
Create Pull Request