Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page relies heavily on Azure PowerShell for all resource creation and configuration steps, with no equivalent Bash, Azure CLI, or Linux-native instructions for these critical tasks. Windows/PowerShell examples are presented first and exclusively in most sections, especially for cluster setup and networking. While the Python client example is cross-platform, the initial steps to create and configure the environment are Windows-centric, creating friction for Linux/macOS users.
Recommendations
- Provide equivalent Azure CLI and/or Bash scripts for all PowerShell-based instructions, especially for resource group, network, storage, and HDInsight cluster creation.
- Explicitly mention that all steps can be performed from Linux/macOS using Azure CLI, and link to relevant CLI documentation.
- Where PowerShell is used for querying resources (e.g., node IP addresses), provide Azure CLI alternatives and show both examples side-by-side.
- Clarify that the Python client code is platform-agnostic and can be run from any OS.
- Add a section or callout for Linux/macOS users, summarizing the recommended workflow and tools.
Create Pull Request