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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation is heavily oriented towards Windows users: all file and directory commands use Windows Command Prompt syntax, file editing is done with Notepad, and troubleshooting uses PowerShell scripts. There are no equivalent Linux/macOS commands or editor suggestions, despite HDInsight clusters being Linux-based. Linux command-line patterns (e.g., mkdir, rm, nano/vi) are missing, and Windows tools are mentioned exclusively or first.
Recommendations:
- Provide Linux/macOS equivalents for all command-line instructions (e.g., use mkdir, cd, rm -rf, nano/vi for file editing).
- Include both Windows and Linux/macOS command blocks side by side or in tabs for each step.
- Suggest cross-platform editors (e.g., VS Code, nano, vi) instead of only Notepad.
- For troubleshooting, provide Linux command-line solutions (e.g., dos2unix, sed) for fixing line endings, not just PowerShell.
- Clarify at the start that instructions are for Windows and provide a parallel set for Linux/macOS users.
- Where possible, use platform-neutral language and tools, especially since HDInsight clusters are Linux-based.
Create pull request