Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a Windows bias in several ways: PowerShell is consistently referenced as the primary interface for device management and configuration, with no equivalent Linux shell or CLI examples. Windows-specific tools and workflows (such as Az cmdlets, remote PowerShell sessions, and Windows VM Guest Agent troubleshooting) are described in detail, while Linux alternatives are absent or minimally mentioned. Examples and workarounds often use Windows commands or utilities (e.g., robocopy, Explorer, Windows mount syntax), and instructions for VM management and custom script extensions focus on Windows VMs, with little or no guidance for Linux VM scenarios.
Recommendations
- Provide equivalent Linux shell (bash) examples for all PowerShell commands and workflows, especially for VLAN configuration, VM management, and Kubernetes operations.
- Include instructions for connecting to the device via SSH and using Linux-native tools (e.g., az CLI, curl, scp) where PowerShell is referenced.
- Add troubleshooting steps and examples for Linux VMs, such as handling custom script extensions and agent updates.
- When listing tools (e.g., AzCopy, sqlcmd), mention installation and usage on Linux as well as Windows.
- Ensure file copy and mount examples include Linux syntax (e.g., cp, rsync, mount commands) alongside Windows equivalents.
- Balance references to Windows-specific utilities (robocopy, Explorer) with Linux alternatives (rsync, Nautilus, etc.).
- Clarify when instructions are Windows-only and provide Linux alternatives where possible.
Create Pull Request