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
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits a Windows-first bias in several areas. The tutorial explicitly states that it uses a Windows computer for examples, with Linux/macOS differences only occasionally noted. Windows-specific tools and patterns (e.g., Docker Desktop for Windows, Windows paths in CLI examples, references to PowerShell/Command Prompt, and links to Windows virtualization documentation) are mentioned before or more prominently than their Linux equivalents. Some commands and environment variable instructions use Windows conventions first or exclusively, and Linux-specific setup steps are less detailed or deferred to external links. There is limited direct guidance for Linux users, and Linux tools or workflows are not presented with equal prominence.
Recommendations
- Provide parallel, equally detailed Linux and macOS instructions and examples throughout the tutorial, not just as side notes or external links.
- Use neutral language and paths in CLI examples (e.g., use $HOME/dev/iotedgesolution or ~/dev/iotedgesolution alongside c:\dev\iotedgesolution).
- Include Linux-first sections or pivots, especially for container engine installation, environment variable setup, and CLI usage.
- Add explicit Linux shell commands (bash/zsh) and troubleshooting steps for common Linux issues (e.g., permissions, Docker group membership).
- Reference Linux documentation and patterns before or alongside Windows equivalents, especially for virtualization, Docker installation, and environment variables.
- Ensure all environment variable and path instructions include both Windows and Linux/macOS formats.
- Highlight Linux-native tools (e.g., Podman, Docker CE, systemd) where appropriate, not just Docker Desktop for Windows.
- Make it clear that the tutorial is equally applicable to Linux/macOS development environments, not just Windows.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-14 00:00 | #250 | in_progress |
Biased
|
| 2026-01-13 00:00 | #246 | completed |
Biased
|
| 2026-01-11 00:00 | #240 | completed |
Biased
|
| 2026-01-10 00:00 | #237 | completed |
Biased
|
| 2026-01-09 00:34 | #234 | completed |
Biased
|
| 2026-01-08 00:53 | #231 | completed |
Biased
|
| 2026-01-06 18:15 | #225 | cancelled |
 Clean
|
| 2025-08-22 00:01 | #88 | completed |
Clean
|
| 2025-08-17 00:01 | #83 | cancelled |
Clean
|
| 2025-07-13 21:37 | #48 | completed |
Clean
|
| 2025-07-12 23:44 | #41 | cancelled |
Biased
|
| 2025-07-09 13:09 | #3 | cancelled |
Clean
|
| 2025-07-08 04:23 | #2 | cancelled |
Biased
|