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 page demonstrates a moderate Windows bias. While the content is generally cross-platform and HDInsight clusters are Linux-based, the documentation repeatedly references Windows-specific tools (such as Azure PowerShell and Windows PowerShell cmdlets) and lists them alongside or before Linux/CLI alternatives. There is a lack of explicit Linux shell or Bash examples, and the 'Related content' section highlights working from a Windows PC. Script actions are described as being available from the Azure portal, HDInsight Windows PowerShell cmdlets, or the .NET SDK, with no mention of Bash or Linux-native scripting. The Azure CLI is mentioned, but not emphasized equally. There are no explicit Linux/Bash command examples, and Windows tools are sometimes mentioned first or exclusively.
Recommendations:
- Ensure that Linux/Bash/CLI examples are provided wherever PowerShell or Windows tools are mentioned, especially for script actions and cluster management.
- When listing setup methods or tools, alternate the order or explicitly state parity between Windows and Linux tools (e.g., 'Azure CLI (Linux/macOS/Windows)' and 'Azure PowerShell (Windows/macOS/Linux)').
- Add explicit Bash or shell script examples for common tasks, especially in sections discussing script actions or automation.
- In the 'Related content' section, include links to guides for working from Linux/macOS as well as Windows.
- Avoid referring to 'Windows PowerShell cmdlets' exclusively; use 'PowerShell' and clarify cross-platform support where applicable.
- Highlight that the Azure CLI is cross-platform and can be used from Linux, macOS, and Windows equally.
Create pull request