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-line examples use PowerShell syntax, even for tasks that are cross-platform (e.g., Azure CLI, Docker, kubectl). There are no explicit Linux/bash equivalents for critical troubleshooting steps, except in the 'Troubleshoot service groups' section, which provides both Bash and PowerShell tabs. This creates friction for Linux/macOS users, especially in sections where only PowerShell is shown and Windows-specific scripting patterns (e.g., ConvertTo-Json, Out-File, [Convert]::ToBase64String) are used.
Recommendations
- Provide Bash/Linux equivalents for all PowerShell examples, especially for Azure CLI, Docker, and kubectl commands.
- Avoid using Windows-specific scripting constructs (e.g., ConvertTo-Json, Out-File) without showing cross-platform alternatives (e.g., jq, echo, cat, base64).
- Where possible, use platform-neutral Azure CLI syntax and highlight cross-platform compatibility.
- Clearly indicate when a command is Windows-only, and provide guidance for Linux/macOS users.
- Review and update sections to ensure Linux/macOS users can follow troubleshooting steps without friction.
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
|