Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias in several ways: PowerShell cmdlets are mentioned as a primary method for RBAC assignments, with no mention of Linux CLI or Bash alternatives. Troubleshooting steps reference Windows-specific concepts (e.g., SMB, 'con' as an invalid directory name) and do not provide parity for Linux environments (e.g., NFS, Linux file naming conventions). The documentation lacks explicit Linux command examples or troubleshooting steps tailored for Linux agents, and Windows tools/patterns are referenced before or instead of Linux equivalents.
Recommendations
- Include Azure CLI and Bash command examples for role assignments and troubleshooting, alongside or before PowerShell.
- Add troubleshooting steps for Linux-specific scenarios, such as NFS mounts, Linux file permissions, and SELinux/AppArmor issues.
- Reference Linux file naming conventions and errors (e.g., reserved names, case sensitivity) in addition to Windows-specific ones.
- Mention Linux tools (e.g., mount, ls, chmod, systemctl) for diagnosing agent and network issues.
- Ensure all examples and guidance are provided for both Windows and Linux environments, or explicitly state platform limitations.
Create Pull Request