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 are provided only in PowerShell syntax, even for tasks that are cross-platform (e.g., Azure CLI, Docker, kubectl). Linux/Bash equivalents are missing for critical troubleshooting steps, except in the 'Troubleshoot service groups' section, where both Bash and PowerShell tabs are provided. This creates friction for Linux/macOS users, who must translate PowerShell-specific commands and scripting patterns to their environment.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell command examples, especially for Azure CLI, Docker, and kubectl commands.
- Avoid using PowerShell-specific scripting constructs (e.g., variable assignment, ConvertTo-Json, Out-File) without offering a Bash alternative.
- Ensure cross-platform parity by showing Bash examples first or side-by-side with PowerShell.
- Clarify when a command is Windows-only or cross-platform.
- Review and update sections where only PowerShell is used for tasks that are not Windows-specific.
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
|