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 documentation for workload orchestration in Azure Arc shows notable Windows bias. Most command-line examples are provided only in PowerShell syntax, even for tasks that are cross-platform (e.g., az CLI, kubectl, docker). There are no explicit Linux/bash equivalents for critical troubleshooting steps, except in the 'service groups' section, where both Bash and PowerShell tabs are provided. Windows/PowerShell syntax is used by default throughout, and some commands (e.g., Base64 encoding, file manipulation) use PowerShell-specific patterns without Linux alternatives.
Recommendations
- Provide Bash/Linux equivalents for all az CLI, kubectl, and docker commands, especially for steps involving file manipulation, Base64 encoding, and JSON creation.
- Use cross-platform syntax for az CLI commands (e.g., avoid PowerShell variable syntax and backticks in examples).
- Add explicit notes or tabs for Linux/macOS users, clarifying any OS-specific steps.
- Ensure file encoding instructions are relevant for Linux/macOS editors (e.g., mention how to check/save UTF-8 encoding in Vim/Nano).
- For Base64 encoding, provide Linux command (e.g., echo -n '<token>' | base64) alongside PowerShell.
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
|