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 provides Linux-oriented troubleshooting steps and command examples (e.g., use of sudo, systemctl, bash shells). However, there is a subtle Windows bias in the ordering and phrasing: Windows-specific advice (such as running PowerShell as Administrator and quoting differences in PowerShell) is often mentioned before or more prominently than Linux equivalents. Additionally, PowerShell is referenced explicitly, and quoting issues in PowerShell are called out, but no equivalent shell-specific advice is given for Linux shells.
Recommendations:
- Ensure that Linux and Windows troubleshooting steps are presented with equal prominence and in parallel structure, rather than mentioning Windows-specific advice first or more prominently.
- When referencing shell-specific behaviors (such as quoting), provide equivalent advice for both Windows (PowerShell, CMD) and Linux (bash, sh, etc.), or clarify when an issue is platform-specific.
- If mentioning PowerShell or Windows command prompts, also mention common Linux shells and their behaviors, especially for users who may be less familiar with Linux.
- Consider providing side-by-side command examples for both Windows and Linux where applicable, especially for common tasks like checking Docker status, running containers, or accessing logs.
- Review the documentation for any implicit assumptions about the user's platform, and strive for parity in the depth and clarity of instructions for both Windows and Linux users.
Create pull request