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
⚠️
missing_linux_example
Summary:
The documentation generally aims for cross-platform parity, but there is a subtle Windows bias. Command-line examples are consistently provided for both Bash (Linux/macOS) and Cmd (Windows), but the Windows/Cmd examples are always listed second, which is positive. However, there is a notable absence of PowerShell-specific examples, which is good. The main bias is that some sections refer to 'command prompt' (a Windows term) alongside 'terminal' and mention Windows in tables before Linux. There are no Linux-specific tools or troubleshooting steps, and some language (e.g., 'open a new command prompt, Bash, or Terminal session') puts Windows terminology first or on equal footing, which can be confusing for Linux users. There are no Linux-only examples or guidance, and the documentation does not mention WSL or other Linux-specific workflows.
Recommendations:
- Ensure that references to 'command prompt' are always paired with 'terminal' or 'shell', and consider putting 'terminal' first to reflect cross-platform usage.
- Where possible, add Linux-specific troubleshooting tips or notes (e.g., file permissions, environment variable export syntax).
- Consider including a short section or callout for WSL users, or for common Linux distributions, to address any OS-specific caveats.
- Continue to provide both Bash and Cmd examples, but consider putting Bash (Linux/macOS) first in all cases to reflect the growing popularity of Linux development environments.
- Review all language to ensure that Windows-specific terms are not used generically (e.g., use 'terminal' instead of 'command prompt' when referring to any shell).
Create pull request