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
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by providing more detailed, step-by-step instructions and screenshots for Windows, including explicit PowerShell commands and Windows-specific tools (e.g., diskpart, Task Manager). Windows procedures are described first and in greater depth, while Linux instructions are less detailed, lack screenshots, and often refer users to external distribution documentation for critical steps. Some Linux steps are described only in general terms or as 'illustrative examples' for specific distributions, without the breadth of explicit, actionable examples seen for Windows.
Recommendations:
- Provide Linux examples with the same level of detail as Windows, including explicit commands for common distributions (e.g., Ubuntu, RHEL, SUSE) for each step.
- Include screenshots or terminal output for key Linux steps, such as checking agent installation or modifying network settings.
- Offer Linux shell command equivalents for all Windows PowerShell/command prompt examples.
- List Linux and Windows procedures in parallel or side-by-side, or alternate which OS is described first to avoid 'windows_first' ordering.
- Reference Linux tools/utilities (e.g., systemctl, nmcli, lsblk) as directly as Windows tools (e.g., diskpart, PowerShell).
- Expand on manual preparation steps for Linux with concrete, distribution-specific commands and troubleshooting tips.
Create pull request