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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a Windows bias by providing only PowerShell examples for command-line operations and referencing Windows-centric tools first. There are no examples or instructions for performing the same tasks using Linux-native tools (such as Bash, Azure CLI, or SSH), which are commonly used in HDInsight clusters that often run on Linux VMs. The REST API section is platform-neutral, but the lack of Linux command-line parity is notable.
Recommendations:
- Add equivalent examples using Azure CLI (az hdinsight ...) for listing and restarting nodes, as Azure CLI is cross-platform and widely used on Linux.
- Include Bash or shell script examples for interacting with the REST API, such as using curl or httpie, to demonstrate how Linux users can perform the same operations.
- Reorganize the documentation to present cross-platform or Linux-native options before or alongside PowerShell, rather than PowerShell first.
- Explicitly mention that the PowerShell examples are for Windows users and provide clear alternatives for Linux/macOS users.
- Consider referencing SSH-based troubleshooting or reboot commands for scenarios where the VM is still accessible via SSH.
Create pull request