Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides three methods for adding users to Ambari: via the portal, PowerShell, and curl/bash. The PowerShell example is given in full detail and appears before the curl/bash example, which is described as requiring 'slight modifications' for Windows. The PowerShell script uses Windows-specific tooling (Invoke-WebRequest, Start-Sleep, etc.), and there is no equivalent Linux shell script or REST API example using common Linux tools (e.g., wget, httpie). The curl/bash example is present, but is positioned after the PowerShell example and is described as requiring modifications for Windows, implying a Windows-first approach. There are no macOS-specific notes or parity checks.
Recommendations
- Present Linux/bash/curl examples before or alongside PowerShell examples to avoid Windows-first ordering.
- Provide a full REST API example using generic tools (curl, wget, httpie) with explicit instructions for Linux/macOS users.
- Clarify that the PowerShell example is for Windows and the curl/bash example is for Linux/macOS, and ensure both are equally detailed.
- Add notes or examples for macOS users where relevant.
- Avoid language that positions Windows tools as the default or primary method.
Create Pull Request