Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits several instances of Windows bias. PowerShell cmdlets and interfaces are frequently referenced for troubleshooting and configuration (e.g., Set-HcsKubernetesAzureMonitorConfiguration, Get-VM, Start-VM), with no equivalent Linux shell or CLI examples provided. Windows-specific tools and patterns (such as robocopy, Explorer, RDP, waappagent.exe, WindowsAzureGuestAgent, and Windows VM Guest Agent version checks) are mentioned, often without Linux alternatives. In some cases, Windows instructions are given before or instead of Linux ones, and Linux-centric workflows are underrepresented or missing entirely.
Recommendations
- Provide equivalent Linux shell/CLI commands and examples wherever PowerShell or Windows tools are referenced (e.g., show how to check VM status or restart VMs using Linux commands).
- Include troubleshooting steps for both Windows and Linux environments, especially for VM and Kubernetes operations.
- Mention Linux tools (such as rsync, cp, scp) alongside Windows tools like robocopy and Explorer for file operations.
- Add guidance for connecting to devices using SSH and Linux utilities, not just RDP and Windows interfaces.
- Ensure that instructions for both platforms are presented in parallel, or at least Linux examples are not omitted or relegated to secondary status.
Create Pull Request