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 is heavily featured, with extensive scripts and troubleshooting focused on Windows tooling. PowerShell examples are more detailed and cover remote job submission, while Linux/macOS examples are limited to basic shell commands. Troubleshooting for line endings is Windows-centric, and there is no mention of macOS-specific issues or tools. PowerShell is presented as the primary remote automation method, with Linux alternatives (e.g., Azure CLI, Bash scripting) missing or underrepresented.
Recommendations
- Add equivalent Azure CLI examples for all PowerShell scripts, enabling Linux/macOS users to automate tasks without PowerShell.
- Include troubleshooting steps for common Linux/macOS issues (e.g., file permissions, SSH key problems), not just Windows line endings.
- Present shell (Linux/macOS) and PowerShell examples side-by-side, rather than giving PowerShell more space and detail.
- Mention and link to cross-platform tools (Azure CLI, REST API) in the prerequisites and throughout the guide.
- Clarify that PowerShell is optional and provide guidance for users on non-Windows platforms.
Create Pull Request