Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page provides examples and guidance for using script actions in Azure HDInsight clusters. While the clusters themselves are Linux-based and script actions are Bash scripts, the documentation consistently lists Windows-centric tools (Azure PowerShell, .NET SDK) before Linux-friendly options (Azure CLI, REST API). Example code and command references are predominantly PowerShell-based, with more detailed PowerShell walkthroughs and output samples. The Azure CLI is mentioned, but with less prominence and fewer detailed examples. There are no Linux shell (bash) or direct SSH examples, and the .NET SDK (Windows-centric) is referenced before REST API or CLI in several sections.
Recommendations
- Present Azure CLI examples before or alongside Azure PowerShell examples, especially since HDInsight clusters are Linux-based.
- Provide more detailed Azure CLI walkthroughs, including output samples and step-by-step instructions, matching the depth of PowerShell examples.
- Include examples of using Bash scripts via SSH for advanced users who may want to interact directly with cluster nodes.
- Reference REST API and CLI options earlier in each section, not just as add-ons after PowerShell and .NET SDK.
- Clarify that PowerShell is cross-platform, but highlight CLI and Bash as native Linux options.
- Balance the documentation so that Linux-native workflows are as discoverable and detailed as Windows/PowerShell workflows.
Create Pull Request