Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page shows moderate Windows bias. PowerShell is mentioned as an alternative method for creating custom images and for uploading VHD files, with no equivalent Bash or Linux CLI examples referenced. Windows tools (sysprep) are described before Linux equivalents (deprovision), and the upload instructions reference Microsoft-centric tools (AzCopy, Storage Explorer, PowerShell) without mentioning Linux-native options. The flow and examples tend to prioritize Windows terminology and tooling.
Recommendations
- Include Bash/Azure CLI examples alongside PowerShell for creating custom images and uploading VHD files.
- Mention Linux-native tools (e.g., dd, qemu-img, SCP, rsync) for VHD creation and upload, where relevant.
- Ensure Linux instructions (e.g., waagent --deprovision) are described with equal detail and prominence as Windows (sysprep).
- Add explicit guidance for Linux users, such as command-line steps for uploading VHDs from Linux environments.
- Balance the order of Windows and Linux instructions, alternating or grouping them to avoid Windows-first presentation.
Create Pull Request