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 examples are provided only in PowerShell syntax, even for tasks that are cross-platform (e.g., Azure CLI, Docker, kubectl). Bash/Linux equivalents are missing for critical troubleshooting steps, except in the 'service groups' section, where both Bash and PowerShell tabs are provided. This creates friction for Linux/macOS users, especially since many Azure CLI and Kubernetes operations are natively cross-platform.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell command examples, especially for Azure CLI, Docker, and kubectl commands.
- Ensure that cross-platform tools (e.g., az, kubectl, docker) are demonstrated in both Bash and PowerShell contexts.
- Where PowerShell-specific syntax is used (e.g., variable assignment, piping, Base64 encoding), offer Bash alternatives (e.g., export, echo, base64).
- Review the troubleshooting steps to ensure Linux/macOS users can follow along without needing to translate PowerShell syntax.
- Consider showing Bash examples first or side-by-side with PowerShell to reinforce parity.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-02-12 00:00 | #238 | in_progress |
 Clean
|
| 2026-02-11 00:00 | #234 | in_progress |
Clean
|
| 2026-02-10 00:00 | #230 | completed |
Biased
|
| 2026-01-13 06:17 | #108 | completed |
Biased
|
| 2026-01-12 00:00 | #100 | completed |
Biased
|
| 2026-01-10 00:00 | #93 | completed |
Clean
|
| 2026-01-06 22:28 | #79 | completed |
Clean
|