About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a Windows bias primarily in the 'Customize HDInsight configs using Bootstrap' section, where only a PowerShell (Windows-centric) example is provided for cluster configuration. There is no equivalent Bash/CLI or Linux-native example, despite HDInsight clusters being Linux-based by default. The PowerShell example is also presented before any mention of Linux-native tooling. Other sections reference Linux (e.g., edge nodes), but the only code sample is Windows-oriented, and there is a lack of parity in scripting guidance for Linux users.
Recommendations:
- Provide equivalent Bash/Azure CLI examples alongside PowerShell for all cluster configuration tasks, especially in the 'Customize HDInsight configs using Bootstrap' section.
- Explicitly mention that HDInsight clusters are Linux-based by default and highlight Linux-native management options (e.g., Azure CLI, Bash scripting, REST API) before or alongside Windows/PowerShell options.
- Ensure that all code samples and automation guidance are available for both Windows and Linux users to avoid platform bias.
- Where PowerShell is referenced, add a note or link to corresponding Linux/CLI documentation.
- Review other sections for subtle prioritization of Windows tools or terminology and ensure Linux parity throughout.
Create pull request