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 examples, including those for Azure CLI, Kubernetes, Docker, and file manipulation, are provided in PowerShell syntax only, with no equivalent Bash or Linux shell examples. Windows-specific scripting patterns (e.g., variable assignment, ConvertTo-Json, Out-File, Base64 encoding via .NET) are used throughout. Bash/Linux examples are only provided in the 'Troubleshoot service groups' section, and even there, PowerShell is shown first or equally. This creates friction for Linux/macOS users, who must translate Windows-centric instructions to their environments.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell command examples, especially for Azure CLI, Docker, and Kubernetes operations.
- Use cross-platform variable assignment and scripting patterns (e.g., environment variables, jq for JSON manipulation, base64 for encoding) instead of PowerShell-specific constructs.
- Where file encoding or manipulation is required, offer Linux/macOS-compatible instructions (e.g., using iconv, cat, jq, etc.).
- Ensure Bash examples are presented before or alongside PowerShell, not after.
- Review all troubleshooting steps for Windows-centric language and tools, and add Linux/macOS guidance as needed.
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
|