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 Azure CLI, kubectl, and Docker commands, are presented in PowerShell syntax, with no equivalent Bash or Linux shell examples for critical troubleshooting steps. Only in the 'Troubleshoot service groups' section are Bash examples provided alongside PowerShell, but the rest of the document lacks Linux parity. This creates friction for Linux/macOS users, who must adapt Windows-centric instructions to their environments.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell command examples, especially for Azure CLI, kubectl, and Docker commands.
- Clearly indicate when a command is cross-platform and provide syntax for both Windows (PowerShell) and Linux/macOS (Bash).
- Avoid using PowerShell-specific constructs (e.g., ConvertTo-Json, Out-File, Base64 encoding via [Convert]) without showing Bash alternatives.
- Review file encoding instructions to ensure they are relevant for Linux/macOS users (e.g., UTF-8 with BOM is a Windows-specific concern).
- Add notes or tabs for Linux/macOS users where file paths, environment variables, or command syntax differ.
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
|