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 syntax. Most examples use PowerShell, even for tasks that are cross-platform (e.g., Azure CLI, Docker, kubectl), and do not provide equivalent Bash or Linux shell examples. Windows-specific patterns (e.g., PowerShell variable syntax, ConvertTo-Json, Out-File) are used without Linux alternatives. Only in the 'Troubleshoot service groups' section are Bash examples provided alongside PowerShell, but elsewhere Linux users must adapt Windows-centric instructions.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell examples, especially for Azure CLI, Docker, and kubectl commands.
- Avoid using Windows-specific PowerShell constructs (e.g., Out-File, ConvertTo-Json) without showing cross-platform alternatives (e.g., jq, echo, cat, >).
- When referencing file encoding, clarify how to check and convert encoding on Linux/macOS (e.g., using iconv or file command).
- Show both Bash and PowerShell tabs for all command sections, not just service group queries.
- Use cross-platform variable syntax in Azure CLI examples (e.g., $var for PowerShell, $var or ${var} for Bash).
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 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
|