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
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a Windows-first bias: all local environment setup commands (directory creation, file deletion, file editing) are provided only in Windows Command Prompt (cmd) syntax, and Notepad is used as the default editor. There are no equivalent Linux/macOS shell commands or editor suggestions, despite the fact that HDInsight clusters themselves run on Linux and many developers use Linux or macOS. The only Unix-style commands appear later, once the user is SSHed into the cluster, but the local development workflow is Windows-centric.
Recommendations:
- Provide equivalent Linux/macOS shell commands (e.g., mkdir, cd, rm) alongside Windows cmd commands for all file and directory operations.
- Suggest cross-platform or Linux-native text editors (e.g., nano, vim, gedit, VS Code) in addition to Notepad.
- Clearly indicate when a command is for Windows or Linux/macOS, using tabs or callouts to separate instructions.
- Consider using platform-agnostic instructions (e.g., 'open pom.xml in your preferred text editor') where possible.
- Explicitly mention that the workflow is cross-platform and provide parity in examples for both environments.
Create pull request