Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Bash/cURL and PowerShell examples for all major steps, but PowerShell (Windows) examples are consistently shown immediately after Bash, and Windows tools (Invoke-WebRequest) are referenced first in the prerequisites. The explanations and variable naming sometimes favor PowerShell workflows, and the Azure CLI is mentioned only for file retrieval, without explicit Linux/macOS parity guidance.
Recommendations
- Alternate the order of Bash and PowerShell examples, or present Bash (Linux/macOS) first to reflect the default HDInsight OS.
- Explicitly mention Linux/macOS compatibility in the prerequisites and throughout the guide.
- Provide more context for Linux/macOS users, such as troubleshooting tips or alternative tools if needed.
- Include a note that all examples work on Linux/macOS unless otherwise stated.
- Ensure that any references to Azure CLI or other tools include installation and usage instructions for Linux/macOS.
Create Pull Request