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
Summary:
The documentation generally maintains good cross-platform parity, but there are subtle signs of Windows bias. In command-line examples, both Bash and Windows CMD are provided, but CMD examples are always listed second, which is a positive sign for Linux parity. However, the documentation refers to 'command prompt' in the getting started section, which is a Windows-specific term, and does not mention Linux shells (e.g., Bash, Zsh) equivalently. There is also a lack of explicit mention of Linux-specific tools or troubleshooting steps, and some terminology (e.g., 'command prompt', 'Terminal') is inconsistent. All Azure CLI examples are provided for both Bash and CMD, but there are no PowerShell-specific examples, which is good. There are no Windows-only tools or patterns, but the documentation could be more explicit in addressing Linux users and their environments.
Recommendations:
- In the getting started section, replace 'command prompt' with 'terminal or command prompt' or explicitly mention both Windows and Linux shells (e.g., 'command prompt (Windows) or terminal (Linux/macOS)').
- Wherever 'Terminal' is mentioned, clarify that it refers to Bash, Zsh, or other shells on Linux/macOS, and Command Prompt or PowerShell on Windows.
- Add troubleshooting tips or notes specific to Linux environments, such as file permissions, environment variable configuration, or common issues with Maven/Java on Linux.
- Ensure that any references to environment variables (e.g., JAVA_HOME) include Linux export syntax as well as Windows set syntax.
- Consider including at least one explicit example of running or debugging on a Linux system, or referencing Linux-specific documentation where appropriate.
- Audit for any other subtle terminology that may assume a Windows-first perspective, and rephrase for cross-platform inclusivity.
Create pull request