Document Details
Diagnose Problems
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 demonstrates a strong Windows bias. All command-line examples are given in PowerShell syntax, with no Bash or Linux shell equivalents. File paths in configuration examples use Windows-style paths (e.g., C:\Users\...), and script execution instructions reference PowerShell scripts (.ps1) exclusively. There is no mention of Linux tools, nor are Linux/Bash alternatives provided for any step, despite the cross-platform nature of Kubernetes and Azure Arc. This may hinder usability for Linux users and does not reflect best practices for cross-platform documentation.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell commands and scripts, using az CLI and kubectl where appropriate.
- Include Linux-style file paths in configuration examples, or clarify that paths should be adapted to the user's OS.
- Explicitly mention that the instructions apply to both Windows and Linux environments, and note any OS-specific differences.
- Offer downloadable Bash scripts (.sh) alongside PowerShell scripts (.ps1) for onboarding and automation tasks.
- Add a section or callouts for Linux users, highlighting any prerequisites or steps unique to Linux environments.
- Ensure screenshots and UI instructions are OS-neutral or provide examples for both Windows and Linux where relevant.
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
|