Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits a moderate Windows bias. Windows examples and PowerShell commands are presented before Linux equivalents, and Windows-centric tools (PowerShell, WindowsServer SKUs) are referenced more frequently and in greater detail. Linux instructions are present but often less detailed or appear after Windows examples. Some advanced tasks (e.g., bringing a .vhd from on-premises) are only shown with Windows PowerShell, with no Linux CLI or Bash equivalent.
Recommendations
- Provide Linux/Bash/Azure CLI examples alongside PowerShell for all major workflows, especially for importing .vhd files and setting VM properties.
- Ensure Linux images and instructions are presented with equal prominence and detail as Windows examples.
- Where PowerShell is used, offer equivalent Azure CLI or Bash commands for Linux/macOS users.
- Explicitly mention Linux-specific considerations or differences in advanced scenarios (e.g., disk import, managed disk creation).
- Balance the order of examples so Linux and Windows are alternated or grouped, rather than consistently leading with Windows.
Create Pull Request