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 PowerShell and Windows-style command usage. Most examples, including those for Azure CLI, Docker, and Kubernetes, are provided only in PowerShell syntax, with no equivalent Bash or Linux shell examples for critical steps. Windows-specific scripting patterns (e.g., variable assignment, Base64 encoding, file encoding checks) are used throughout, and Linux/macOS users are not given parity guidance. Bash examples are only provided in the 'service groups' section, and even there, PowerShell is shown first or equally, but the rest of the document is Windows-centric.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell command examples, especially for Azure CLI, Docker, and Kubernetes steps.
- Use cross-platform variable syntax and avoid Windows-specific scripting patterns (e.g., PowerShell variable assignment, Base64 encoding).
- Explicitly mention file encoding checks for Linux/macOS users (e.g., how to check/save UTF-8 files in Linux editors).
- Ensure that troubleshooting steps can be followed on Linux/macOS, including Docker and kubectl commands.
- Where PowerShell is used for scripting, offer Bash alternatives or clarify which steps are Windows-only.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 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
|