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 a Linux-oriented approach (e.g., file paths, use of bash), but in sections providing command-line examples, PowerShell/Windows syntax is consistently presented immediately after bash, and sometimes without clear distinction or context. The PowerShell examples are not always necessary, and the order (bash first, then PowerShell) could suggest a slight Windows-first bias. There are also notes and caveats specific to Docker on Windows, but no equivalent depth for Linux, which may reinforce a perception of Windows primacy.
Recommendations:
- Clearly label command examples as 'Linux/macOS (bash)' and 'Windows (PowerShell)' to avoid confusion and ensure parity.
- Consider whether PowerShell examples are necessary for every scenario, especially when the primary deployment target is Linux-based containers.
- Provide equivalent troubleshooting notes and caveats for Linux environments, not just for Windows and macOS.
- If both bash and PowerShell examples are included, alternate their order in different sections or group them under clearly marked subheadings.
- Explicitly state the intended audience/platform for each example to help users quickly find relevant information.
Create pull request