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
windows_first
missing_linux_example
Summary
The documentation page exhibits a strong Windows bias, especially in the 'Troubleshoot staging' and related orchestration sections. Most troubleshooting steps and code examples use PowerShell syntax and Windows-centric command patterns, with little to no mention of Linux/macOS equivalents. Only in the 'Troubleshoot service groups' section are Bash examples provided alongside PowerShell, but elsewhere, Linux users are left to adapt Windows-specific instructions themselves.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell commands, especially for az, docker, and kubectl usage.
- Avoid using PowerShell-specific constructs (e.g., ConvertTo-Json, Out-File, [Convert]::ToBase64String) without showing how to achieve the same in Bash.
- Explicitly mention cross-platform compatibility for commands and clarify any OS-specific requirements.
- Order examples so that Bash/Linux commands are presented first or side-by-side with PowerShell, not only in a separate tab for a single section.
- Review file encoding instructions to include Linux/macOS editors and workflows.
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
|