Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits Windows bias primarily in the 'Customize HDInsight configs using Bootstrap' section, where only a PowerShell example using the AZ module is provided for cluster configuration. There is no equivalent example for Linux users (e.g., Bash/CLI/ARM template), and the use of PowerShell and Windows-centric Azure tools is emphasized. Additionally, Windows tools and patterns (PowerShell, AZ module) are mentioned before any Linux alternatives, and Linux-specific instructions are missing in key configuration sections.
Recommendations
- Provide equivalent Linux/Bash examples for cluster configuration, such as using Azure CLI or ARM templates.
- Include instructions for managing HDInsight clusters using Linux-native tools and scripts, not just PowerShell.
- Ensure that examples and tooling references are presented in parallel for both Windows and Linux users.
- Add explicit guidance for Linux users in sections where only Windows/PowerShell instructions are given.
- Review other sections for subtle Windows-first language or tool references and balance with Linux alternatives.
Create Pull Request