Document Details
Troubleshooting
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
powershell_heavy
windows_first
missing_linux_example
Summary
The troubleshooting guidance for workload orchestration is heavily biased toward Windows/PowerShell usage. Most command-line examples are provided only in PowerShell syntax, even for cross-platform tools like Azure CLI, Docker, and kubectl. Linux/Bash equivalents are missing for critical troubleshooting steps, except for the 'service groups' section, which offers both Bash and PowerShell tabs. This creates friction for Linux/macOS users, as they must translate PowerShell-specific syntax and patterns to Bash or their preferred shell.
Recommendations
- Provide Bash/Linux equivalents for all PowerShell command examples, especially for Azure CLI, Docker, and kubectl commands.
- Avoid using PowerShell-specific constructs (e.g., variable syntax, ConvertTo-Json, Out-File) in generic cross-platform guidance; use platform-neutral syntax or offer both versions.
- Clearly indicate when a command is Windows-only, and provide alternative instructions for Linux/macOS where possible.
- Review file encoding guidance to ensure it is relevant for Linux/macOS users (e.g., UTF-8 with BOM is a Windows-specific concern).
- For scripting steps (e.g., Base64 encoding, JSON file creation), offer Bash/Linux alternatives (e.g., using echo, base64, jq, etc.).
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-03-10 00:00 | #475 | in_progress |
Biased
|
| 2026-03-09 00:00 | #471 | in_progress |
Biased
|
| 2026-03-08 00:00 | #467 | in_progress |
Biased
|
| 2026-03-07 00:00 | #463 | in_progress |
Biased
|
| 2026-03-06 00:00 | #459 | in_progress |
Biased
|
| 2026-03-05 00:00 | #455 | in_progress |
Biased
|
| 2026-03-04 00:00 | #451 | in_progress |
Biased
|
| 2026-03-03 00:00 | #447 | in_progress |
Biased
|
| 2026-03-02 00:00 | #443 | in_progress |
Biased
|
| 2026-03-01 00:00 | #439 | in_progress |
Biased
|
| 2026-02-28 00:00 | #435 | in_progress |
Biased
|
| 2026-02-27 00:00 | #431 | in_progress |
Biased
|
| 2026-02-26 00:00 | #427 | in_progress |
Biased
|
| 2026-02-25 00:00 | #423 | in_progress |
Biased
|
| 2026-02-23 00:00 | #415 | in_progress |
Biased
|
| 2026-02-22 00:00 | #411 | in_progress |
Biased
|
| 2026-02-21 00:00 | #407 | in_progress |
Biased
|
| 2026-02-20 00:00 | #403 | in_progress |
Biased
|
| 2026-02-19 00:00 | #399 | in_progress |
Biased
|
| 2026-02-18 00:00 | #395 | in_progress |
Biased
|
| 2026-02-17 00:00 | #391 | in_progress |
Biased
|
| 2026-02-16 00:00 | #387 | in_progress |
Biased
|
| 2026-02-15 00:00 | #383 | in_progress |
Biased
|
| 2026-02-14 00:00 | #379 | in_progress |
Biased
|
| 2026-02-13 00:00 | #375 | in_progress |
Biased
|
| 2026-02-12 00:00 | #371 | in_progress |
Biased
|
| 2026-02-11 00:00 | #367 | in_progress |
 Clean
|
| 2026-02-10 00:00 | #363 | completed |
Biased
|
| 2026-02-09 00:00 | #359 | completed |
Biased
|
| 2026-02-08 00:00 | #355 | completed |
Biased
|
| 2026-01-14 00:00 | #251 | completed |
Biased
|
| 2026-01-13 00:00 | #247 | completed |
Biased
|
| 2026-01-11 00:00 | #241 | completed |
Biased
|
| 2026-01-10 00:00 | #238 | completed |
Biased
|
| 2026-01-09 00:34 | #235 | completed |
Biased
|
| 2026-01-08 00:53 | #232 | completed |
Biased
|