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:
Summary:
The documentation exhibits a mild 'windows_first' bias in the prerequisites section, where Bash usage is described specifically as 'the Bash shell on Windows 10' and installation instructions are linked for Windows Subsystem for Linux (WSL) on Windows 10. There is no mention of native Linux or macOS environments, and no guidance for users running the Azure CLI from those platforms. All CLI examples use Bash syntax, which is cross-platform, but the only explicit environment guidance is for Windows users.
Recommendations:
- Update the prerequisites section to mention that the Azure CLI and Bash examples work natively on Linux and macOS, not just on Windows (WSL).
- Provide installation links or brief instructions for Bash and Azure CLI on Linux and macOS, in addition to the current WSL/Windows guidance.
- Clarify that the examples are cross-platform and specify any differences (if any) for Linux, macOS, or Windows Command Prompt/PowerShell.
- Consider adding a short note or table summarizing how to adapt the examples for Windows Command Prompt or PowerShell, if relevant.
Create pull request