Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits a moderate Windows bias. Several examples and workarounds rely on PowerShell cmdlets and Windows-specific tools (e.g., Set-HcsKubernetesAzureMonitorConfiguration, Get-VM, Start-VM, robocopy, Explorer, Windows VM Guest Agent troubleshooting, and RDP). In many cases, only Windows instructions or tools are provided, with Linux equivalents missing or mentioned later. Some examples (e.g., mounting NFS shares) use Windows syntax first, and troubleshooting steps for VM extensions are Windows-only. However, Linux is referenced in some places (e.g., AzCopy, NFS, IoT Edge on Linux VM), and some issues/workarounds are relevant to both platforms.
Recommendations
- Provide Linux/macOS equivalents for PowerShell cmdlets, such as Bash/CLI commands for managing VMs and monitoring.
- Include Linux-specific troubleshooting steps alongside Windows instructions, especially for VM management and extension deployment.
- When giving examples (e.g., mounting NFS shares, copying files), show both Windows and Linux command syntax, or alternate which is presented first.
- Reference cross-platform tools where possible (e.g., AzCopy, SQLCMD) and clarify platform-specific usage.
- Explicitly call out when a workaround or feature is Windows-only, and suggest alternatives for Linux/macOS users.
Create Pull Request