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
⚠️
windows_tools
Summary:
The documentation demonstrates some Windows bias, particularly in the ordering and inclusion of examples for command-line usage. In several places, Windows-specific shells (Cmd, PowerShell) are presented before or more prominently than Linux/macOS equivalents. PowerShell is treated as a first-class language option, and Windows command-line patterns are detailed alongside or before bash equivalents. However, Linux/macOS instructions are present, and the use of cross-platform tools like curl and azd is consistent.
Recommendations:
- Ensure that Linux/macOS examples are always presented first or at least with equal prominence to Windows examples, especially in tabbed code blocks.
- Where possible, use neutral terms like 'terminal' instead of 'command prompt' or clarify that both are supported.
- For PowerShell, clarify its availability on Linux/macOS or provide bash/zsh equivalents where appropriate.
- In sections where multiple shell examples are given, consider defaulting to bash (Linux/macOS) first, as it is more universally available across platforms.
- Audit all code snippets and instructions to ensure that Linux users are not required to mentally translate from Windows-specific instructions.
- Explicitly mention cross-platform compatibility for all tools and commands, and provide troubleshooting tips for common Linux/macOS issues.
Create pull request