Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
🔧
Windows Tools
Summary
The documentation page exhibits a notable Windows bias. The 'Prepare on-premises machines' section provides detailed, step-by-step instructions for Windows, including references to Windows-specific settings, services, PowerShell usage, and Windows Firewall configuration. In contrast, Linux preparation is covered in only two brief bullet points, lacking detail and omitting common Linux tasks (e.g., SELinux, iptables, SSH hardening, package updates). Windows tools and patterns (PowerShell, Windows Firewall, RDP) are mentioned exclusively or before Linux equivalents, and Windows examples precede Linux ones throughout.
Recommendations
- Expand the 'Prepare Linux machines' section to include detailed steps equivalent to the Windows section, such as checking and configuring SELinux/AppArmor, managing iptables/firewalld rules, ensuring SSH key-based authentication, and verifying package updates.
- Provide Linux-specific troubleshooting steps and links, similar to those given for Windows.
- Include examples for enabling remote access on Linux (e.g., SSH configuration commands, firewall rules with iptables or firewalld).
- Present Windows and Linux instructions in parallel, or clearly separate them, to avoid implicit prioritization.
- Reference Linux tools and commands (e.g., systemctl, ufw, iptables) where appropriate.
- Ensure parity in guidance for both OSes, including automation and scripting options (e.g., Bash scripts, Ansible for Linux).