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 Windows-first bias by prioritizing Windows and PowerShell instructions, referencing Windows-specific tools (WSL, PowerShell), and providing more detailed, step-by-step guidance for Windows users. Linux and macOS instructions are less detailed and lack parity in example commands or troubleshooting. There are also references to Windows path conventions and Docker Desktop, with less emphasis on native Linux workflows.
Recommendations:
- Provide equally detailed, step-by-step instructions for Linux and macOS users, including explicit shell commands for cloning repositories, navigating directories, and running scripts.
- Avoid assuming Docker Desktop as the default; mention native Docker Engine for Linux and provide installation links for all platforms.
- List Linux/macOS instructions before or alongside Windows instructions to avoid a Windows-first impression.
- Include troubleshooting notes and path conventions relevant to Linux/macOS (e.g., forward slashes, permissions).
- Where PowerShell or Windows-specific commands are given, provide equivalent bash/zsh commands for Linux/macOS.
- Clarify when WSL is only needed for Windows, and offer native Linux alternatives where possible.
- Add screenshots or terminal output examples from Linux/macOS environments, not just Windows.
Create pull request