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
Summary:
The documentation provides both Bash and PowerShell examples for Azure CLI commands. However, the PowerShell examples are labeled as 'Formatted for PowerShell' and are given equal prominence to the Bash examples, despite Bash being the default shell on Linux and macOS. Additionally, variable assignment in PowerShell is shown even when the Bash example is already present, which may not be necessary. There is no explicit mention of Linux or macOS, and the documentation does not clarify that Bash examples are suitable for those platforms, potentially leading to a subtle Windows/PowerShell bias.
Recommendations:
- Clearly indicate that Bash examples are intended for Linux/macOS and PowerShell examples are for Windows.
- List Bash (Linux/macOS) examples first, as Azure CLI is cross-platform and Bash is the default on non-Windows systems.
- Add a short note explaining which shell to use on each OS.
- If both examples are provided, ensure parity in explanation and avoid implying PowerShell is the primary or default environment.
- Consider adding a tabbed interface or clearer separation for Bash and PowerShell to avoid confusion.
Create pull request