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 demonstrates a subtle Windows bias by referencing Windows 10 and the Windows Subsystem for Linux (WSL) as the primary environment for running Bash, and by providing installation guidance specifically for WSL on Windows 10. While all CLI examples use Bash syntax, the documentation positions Windows (with WSL) as the default context, and only briefly mentions that examples can be adapted for the Windows Command prompt, without providing explicit Windows Command Prompt or PowerShell examples. There are no explicit Linux-native instructions or examples, nor are there PowerShell-heavy or Windows tools used in the commands.
Recommendations:
- Present Bash usage in a platform-neutral way, e.g., 'The examples use Bash syntax, which is available on Linux, macOS, and Windows (via WSL or other means)'.
- Provide explicit instructions or notes for running the examples on native Linux and macOS systems, not just Windows with WSL.
- If mentioning WSL, also mention native Linux and macOS as supported environments.
- Consider including a table or section that shows how to adapt the variable setting and commands for Windows Command Prompt and/or PowerShell, or link to a guide for translating Bash to Windows shell syntax.
- Avoid positioning Windows as the default or primary platform unless there is a technical reason.
Create pull request