Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page exhibits mild Windows bias. PowerShell is mentioned as a management option, and references to Azure PowerShell are provided before Linux alternatives. While Azure CLI examples are present (which are cross-platform), PowerShell is called out as a separate option, and there is no explicit mention of Bash or Linux shell equivalents for some tasks. Additionally, the script action log file path uses backslashes (\), which is a Windows convention, and could confuse Linux users. However, the majority of troubleshooting steps focus on Ambari (Linux-based) and command-line tools like curl and netstat, which are standard on Linux. There are no critical sections that are Windows-only, but Linux parity could be improved.
Recommendations
- Provide explicit Bash/Linux shell examples alongside PowerShell commands.
- Use forward slashes (/) for file paths when referring to storage locations, or clarify path conventions for both platforms.
- When listing management tools, mention Azure CLI and Bash/Linux shell options before or alongside PowerShell.
- Clarify that Azure CLI is cross-platform and provide links to Linux/macOS installation instructions.
- Add troubleshooting steps or examples that use SSH and native Linux tools for cluster management.
Create Pull Request