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 and variables, even for cross-platform Azure CLI and Kubernetes tasks. There are no explicit Linux/bash equivalents for critical troubleshooting steps, except for the 'service groups' section, which provides both Bash and PowerShell tabs. Some commands (e.g., Docker, kubectl) are shown in PowerShell context, but these tools are cross-platform. This bias creates friction for Linux/macOS users, who must adapt PowerShell syntax and variable usage to their environments.
Recommendations
- Provide Bash/Linux equivalents for all troubleshooting steps, especially for Azure CLI, Docker, and kubectl commands.
- Use cross-platform variable syntax (e.g., $VAR for Bash, $var for PowerShell) or clarify variable usage for each platform.
- Where possible, avoid PowerShell-specific constructs (e.g., ConvertTo-Json, Out-File) and offer alternatives for Bash/Linux (e.g., jq, echo, cat).
- For file encoding instructions, specify cross-platform editors and commands.
- Clearly indicate which steps are platform-specific and which are cross-platform.
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
|