Document Details
Tutorial Custom Container
❌
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
⚠️
missing_linux_example
⚠️
powershell_heavy
Summary:
The documentation is structured with a clear separation between Windows and Linux instructions using pivots. However, the Windows section is presented first and is significantly more prescriptive, with detailed step-by-step instructions using Windows-specific tools (Visual Studio, Windows Explorer, PowerShell scripts, Docker for Windows). The Windows example is tightly coupled to the Windows ecosystem (e.g., installing fonts via Windows Explorer, using .sln files, and PowerShell scripts), while the Linux section is more generic, CLI-focused, and uses a different sample app (Django/Flask vs. ASP.NET). There is no Linux equivalent for the Windows-specific scenario (custom fonts in the OS), and the Windows workflow is heavily dependent on Visual Studio and PowerShell, with no cross-platform alternatives suggested.
Recommendations:
- Provide Linux-first or at least parallel Linux and Windows instructions, ensuring neither is prioritized by order or detail.
- For scenarios like installing custom fonts or OS-level dependencies, include a Linux example (e.g., installing fonts in a Linux container) to demonstrate parity.
- Offer cross-platform alternatives to Visual Studio and PowerShell, such as VS Code, Docker CLI, or Bash scripts, and reference them in both pivots.
- Where possible, use sample apps and workflows that are analogous across both platforms, so users can see how to achieve similar outcomes regardless of OS.
- Explicitly mention when a scenario is only possible on Windows or Linux, and provide rationale or workarounds for the other platform.
- Avoid assuming the user is on Windows in shared prerequisites or introductory sections; clarify platform-specific requirements in each pivot.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-09-16 00:00 | #113 | completed | ✅ Clean |
| 2025-09-15 00:00 | #112 | completed | ✅ Clean |
| 2025-09-14 00:00 | #111 | completed | ✅ Clean |
| 2025-09-13 00:00 | #110 | completed | ✅ Clean |
| 2025-09-12 00:00 | #109 | completed | ✅ Clean |
| 2025-09-11 00:00 | #108 | completed | ✅ Clean |
| 2025-09-10 00:00 | #107 | completed | ✅ Clean |
| 2025-09-09 00:00 | #106 | completed | ✅ Clean |
| 2025-08-17 00:01 | #83 | in_progress | ❌ Biased |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |
| 2025-07-09 13:09 | #3 | cancelled | ✅ Clean |
| 2025-07-08 04:23 | #2 | cancelled | ❌ Biased |