Document Details
Tutorial Develop For Linux
❌
This page contains Windows bias
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
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows-first bias in several areas: it explicitly states that the tutorial uses a Windows computer, provides Windows paths and commands before Linux equivalents, and references Windows-specific tools and patterns (such as Docker Desktop for Windows and Windows Subsystem for Linux). While it mentions Linux and macOS, Linux-specific instructions and examples are often less detailed or are referenced as external links. There is also a tendency to present Windows installation steps and terminology before Linux alternatives, and some environment variable examples and path conventions are Windows-centric. No PowerShell-specific commands are present, but the overall flow and examples assume a Windows development environment.
Recommendations:
- Provide parallel, side-by-side instructions and examples for Linux (and macOS) wherever Windows-specific steps, paths, or tools are mentioned. For example, show both Windows and Linux commands for creating directories, setting environment variables, and file paths.
- Avoid stating that the tutorial 'uses a Windows computer' as the default; instead, clarify that the steps apply equally to Windows, Linux, and macOS, and highlight any differences as needed.
- When referencing Docker Desktop, include explicit instructions for Docker Engine on Linux, and clarify when WSL is required or optional.
- Ensure that environment variable instructions and path conventions are shown for both Windows (%APPDATA%\Python) and Linux/macOS (~/.local/), not just one or the other.
- Wherever possible, avoid Windows-centric terminology (such as 'command prompt') in favor of cross-platform terms (such as 'terminal').
- Add Linux/macOS-specific troubleshooting tips and common issues, not just those relevant to Docker Desktop on Windows.
- Consider using tabs or callouts to separate Windows and Linux/macOS instructions, so users can easily follow the steps for their platform.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-08-22 00:01 | #88 | completed | ✅ Clean |
| 2025-08-17 00:01 | #83 | in_progress | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ✅ Clean |
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
| 2025-07-09 13:09 | #3 | cancelled | ✅ Clean |
| 2025-07-08 04:23 | #2 | cancelled | ❌ Biased |
Flagged Code Snippets
mkdir c:\dev\iotedgesolution
cd c:\dev\iotedgesolution