Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Summary
The documentation demonstrates a notable Windows bias. In critical migration and deployment sections, examples and templates (Bicep, ARM, PowerShell) are exclusively or primarily for Windows VMs, with explicit references to Windows images, PowerShell, and Windows-specific extension types. Linux equivalents are either missing, mentioned as alternatives without examples, or relegated to notes. PowerShell is emphasized as the main scripting tool, with Linux instructions and bash commands only present in the removal section. The use of 'HybridWorkerForWindows' as the default extension type in code samples further reinforces this bias.
Recommendations
- Provide full Bicep and ARM template examples for Linux VMs, including image references and extension types (e.g., 'HybridWorkerForLinux').
- Include PowerShell and Azure CLI commands specifically for Linux VMs, demonstrating installation and management of the Hybrid Worker extension.
- Ensure REST API examples clearly show both Windows and Linux extension types, with sample payloads for each.
- Present Linux and Windows instructions side-by-side or in parallel tabs, rather than Windows-first or Windows-only.
- Expand Linux prerequisites and troubleshooting sections to match the depth of Windows coverage.
- Reference Linux-specific documentation and tools where appropriate, not just Windows/PowerShell.