Document Details
Best Practices
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
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates moderate Windows bias in several areas. Windows-specific tools (PowerShell) and examples are mentioned or shown before their Linux equivalents, particularly in sections about discovering EOL dates and preparing data disks. Some guidance is Windows-centric (e.g., directory junctions, Windows Services, autouser pool scope for Windows nodes), and PowerShell is referenced more frequently than Linux shell commands. Linux examples are present but less detailed or appear after Windows instructions.
Recommendations
- Ensure Linux and macOS examples are provided alongside Windows/PowerShell examples, especially for critical tasks like disk preparation and resource discovery.
- Present Linux and Windows instructions in parallel, or alternate which platform is shown first in examples.
- Include equivalent Linux shell commands (e.g., bash, CLI) wherever PowerShell is referenced.
- Expand on Linux-specific best practices (e.g., systemd usage, disk mounting) to match the detail given for Windows.
- Add explicit macOS notes where relevant, or clarify platform limitations.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-13 06:17 | #107 | completed |
Biased
|
| 2026-01-12 00:00 | #99 | completed |
Biased
|
| 2026-01-11 06:20 | #98 | completed |
Biased
|
| 2026-01-10 00:00 | #92 | completed |
 Clean
|
| 2026-01-06 22:28 | #78 | completed |
Clean
|
| 2025-12-29 18:00 | #48 | cancelled |
Clean
|
| 2025-12-15 00:00 | #7 | completed |
Clean
|
| 2025-12-14 05:05 | #6 | completed |
Clean
|