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 examples and command snippets are provided in PowerShell syntax, with only a few Bash examples appearing in the 'Troubleshoot service groups' section. Many steps, especially those involving Azure CLI, Docker, and Kubernetes, are shown exclusively in PowerShell, even though these tools are cross-platform and commonly used on Linux/macOS. There are missing Linux/Bash equivalents for critical troubleshooting steps, which creates friction for non-Windows users.
Recommendations
- Provide Bash/Linux equivalents for all PowerShell command snippets, especially for Azure CLI, Docker, and Kubernetes commands.
- Use cross-platform syntax (e.g., az CLI, kubectl, docker) in examples, and avoid PowerShell-specific constructs unless necessary.
- Clearly indicate when a command is platform-specific, and offer alternatives for Linux/macOS users.
- Review and update the troubleshooting steps to ensure Linux/macOS users can follow them without needing to translate PowerShell syntax.
- Where PowerShell is used for scripting (e.g., variable assignment, Base64 encoding), provide Bash alternatives (e.g., export, base64 commands).
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
|