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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation displays some Windows bias, most notably by mentioning Windows-specific tools (Docker Desktop) and conditions ("If you are using Windows, you must have Docker Desktop running") without providing equivalent Linux guidance. In addition, when discussing file paths, it instructs users to use Linux-style slashes even on Windows, but does not provide explicit Linux path examples or clarify Linux-specific behaviors. The only explicit OS-specific note is for Windows (Docker Desktop), and there is no mention of Linux-specific requirements or troubleshooting. The order of OS mentions in the note about running Azure CLI in Docker also lists Windows before macOS and Linux.
Recommendations:
- Add explicit Linux (and macOS) instructions for Docker installation and requirements, e.g., mention that on Linux, Docker Engine or Podman should be running, and provide troubleshooting tips for common Linux issues.
- When referencing Docker Desktop for Windows, also mention the equivalent for Linux (Docker Engine, Podman, etc.), and clarify that Docker Desktop is not required on Linux.
- Provide Linux-specific file path examples and clarify any differences in file system handling or permissions that may affect Linux users.
- Ensure that when listing OS options, Linux is mentioned first or at least equally, and provide parity in examples and troubleshooting steps.
- Add a section or notes for Linux users regarding prerequisites, permissions (e.g., needing to use sudo for Docker), and any common pitfalls.
Create pull request