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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a moderate Windows bias. Portal-based troubleshooting steps are described using generic UI instructions, but when command-line examples are given, PowerShell and Windows-specific tools are often mentioned or prioritized. For example, the section on verifying container image accessibility refers to running Docker in an 'elevated command prompt' and specifically calls out 'Docker on Windows', without mentioning Linux or macOS equivalents. When discussing Azure CLI and PowerShell, the PowerShell module is given its own tab and update instructions, but there is no equivalent for Linux shell environments beyond a single Bash example. There are no explicit Linux/macOS troubleshooting notes or examples, and Windows terminology (e.g., 'elevated command prompt') is used exclusively.
Recommendations:
- Wherever 'elevated command prompt' or 'Docker on Windows' is mentioned, add equivalent instructions for Linux (e.g., 'open a terminal and run with sudo if needed') and macOS.
- When referencing Docker, clarify that the command works on all platforms and provide links to Docker installation instructions for Linux and macOS, not just Windows.
- For Azure CLI and PowerShell instructions, ensure parity by providing Bash/zsh examples and update instructions for Linux/macOS environments, not just PowerShell.
- Avoid Windows-specific terminology (like 'elevated command prompt') or always pair it with cross-platform equivalents.
- Explicitly state that all CLI commands are cross-platform unless otherwise noted, and provide troubleshooting notes for common Linux/macOS issues where relevant.
Create pull request