About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a Windows-first bias by referencing Windows VM creation in the introductory section and providing a detailed, step-by-step Windows agent installation process before mentioning Linux. Linux instructions are less detailed and lack direct package commands or examples. Throughout the guide, there is a lack of parity in practical Linux examples, and the initial VM creation link points only to Windows VMs.
Recommendations:
- Provide parallel links and references for both Windows and Linux VM creation in the introduction (e.g., link to both /azure/virtual-machines/windows/quick-create-portal and /azure/virtual-machines/linux/quick-create-portal).
- Ensure that all instructions and examples (such as agent installation) are equally detailed for Linux, including explicit package manager commands (e.g., 'sudo apt install walinuxagent' or 'sudo yum install WALinuxAgent').
- Where screenshots or UI steps are shown, clarify that the process is identical for both Windows and Linux VMs, or note any differences.
- Include troubleshooting or verification steps for Linux agent installation, similar to the Windows example (e.g., checking the agent version with 'waagent --version').
- Review the documentation for any other implicit prioritization of Windows and ensure Linux users are equally supported throughout.
Create pull request