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
windows_tools
Summary
The documentation page exhibits a strong Windows bias, particularly in the troubleshooting sections for workload orchestration. Most command-line examples are provided exclusively in PowerShell, with no equivalent Bash or Linux shell commands for key troubleshooting steps. Windows-centric tools and patterns (such as PowerShell-specific syntax, file encoding notes about 'UTF-8 with BOM', and use of ConvertTo-Json/Out-File) are used throughout, while Linux alternatives are missing or only appear later in the document. Only in the 'Troubleshoot service groups' section are Bash examples provided alongside PowerShell, but the rest of the page lacks Linux parity.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell commands, especially in troubleshooting steps for staging, authentication, and registry management.
- Include notes about file encoding and manipulation that are relevant for Linux users (e.g., using iconv or sed for encoding changes, jq for JSON creation).
- Avoid Windows-specific syntax (such as PowerShell variable notation and cmdlets) in generic troubleshooting steps, or provide cross-platform alternatives.
- Ensure that both Windows and Linux users are equally supported in all troubleshooting scenarios, with clear instructions for each platform.
- Add explicit guidance for running Azure CLI and kubectl commands on Linux, including any differences in output or required environment setup.
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
|