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_tools
⚠️
windows_first
Summary:
The documentation is primarily focused on Linux (Ubuntu) scripting and usage, with all code examples and best practices centered on Bash and Linux tools. However, there is a subtle Windows bias in the way that Windows-based tools (Azure PowerShell, .NET SDK) are listed as primary methods for applying script actions, and in the troubleshooting section, where the root cause of common errors is attributed to authoring scripts on Windows. The documentation does not provide Linux CLI (az CLI) examples for managing script actions, and Windows-centric tools are often mentioned before Linux equivalents.
Recommendations:
- Add examples and instructions for using the Azure CLI (az CLI), which is cross-platform and preferred by many Linux users, for applying script actions.
- When listing methods for applying script actions, mention cross-platform tools (like Azure CLI) before or alongside Windows-specific tools (PowerShell, .NET SDK).
- In troubleshooting sections, provide guidance for both Windows and Linux users, such as how to convert line endings on both platforms.
- Where possible, avoid assuming scripts are authored on Windows; instead, provide neutral language that addresses both Windows and Linux development environments.
- Include links to Linux-native tools and documentation for managing HDInsight clusters, not just PowerShell or .NET SDK references.
Create pull request