Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation provides both shell (Linux/macOS) and PowerShell (Windows) examples for uploading files and running Hive/Pig jobs. However, PowerShell examples are more detailed, appear first in some sections, and troubleshooting is heavily PowerShell-centric. There is a notable emphasis on PowerShell tools and workflows, with specific troubleshooting steps only for Windows line endings and PowerShell scripts. Some advanced features (e.g., remote Pig jobs) are only documented for PowerShell, and limitations for Linux users are not fully addressed.
Recommendations
- Provide equivalent Bash or Linux/macOS shell scripts for all PowerShell examples, especially for remote job submission and error retrieval.
- Include troubleshooting steps for common Linux/macOS issues (e.g., file permissions, SSH key problems, line endings from macOS editors).
- Ensure Linux/macOS shell examples are presented before or alongside PowerShell examples to avoid Windows-first bias.
- Clarify any limitations or differences for Linux/macOS users (e.g., remote Pig job submission) and suggest workarounds.
- Add links to Linux/macOS tool documentation where PowerShell tools are referenced.
Create Pull Request