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_tools
missing_linux_example
windows_first
Summary
The troubleshooting documentation for workload orchestration is heavily biased toward Windows and PowerShell usage. Most command-line examples (especially in critical troubleshooting sections) use PowerShell syntax and Windows-specific patterns, with little to no equivalent Bash or Linux shell examples. Windows tools and conventions (such as PowerShell variables, ConvertTo-Json, Out-File, and [Convert]::ToBase64String) are used exclusively, and Linux alternatives are not mentioned. Only in the 'service groups' section are Bash examples provided, and even there, PowerShell is shown first in some places. This creates friction for Linux/macOS users attempting to follow the troubleshooting steps.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell commands, especially in troubleshooting steps.
- Replace or supplement Windows-specific tools (e.g., ConvertTo-Json, Out-File) with cross-platform alternatives (e.g., jq, echo, cat, base64).
- Ensure variable syntax is compatible with Bash (e.g., $var vs. ${var}).
- Clearly indicate which commands are platform-specific and offer alternatives or notes for Linux/macOS users.
- Where possible, use platform-neutral Azure CLI commands and avoid PowerShell-only constructs.
- Present Bash/Linux examples before or alongside PowerShell examples to avoid implicit prioritization.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 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
|