Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Bash and PowerShell examples for all tasks, but consistently lists Windows/PowerShell options first and includes explicit references to Windows tools and environments (e.g., Bash on Ubuntu on Windows 10, Windows Subsystem for Linux, Windows PowerShell, and jq for Windows). There are multiple mentions of Windows-specific setup and usage patterns, and PowerShell is presented as a primary alternative to Bash. Linux/macOS users are supported, but the documentation is clearly oriented towards Windows users.
Recommendations
- List Bash/Linux examples before PowerShell/Windows examples to reflect the native platform for HDInsight clusters.
- Remove or de-emphasize references to Windows Subsystem for Linux and Bash on Windows in prerequisites; instead, mention native Linux/macOS shells first.
- Add explicit instructions for running commands on native Linux/macOS environments, including installation steps for jq and curl.
- Clarify that all examples work natively on Linux/macOS and provide troubleshooting tips for those platforms.
- Where Windows-specific tools (e.g., PowerShell, jq-win64) are mentioned, provide equivalent Linux/macOS instructions or alternatives.
- Avoid implying that Windows is the default or preferred environment for cluster management tasks.
Create Pull Request