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 page exhibits several signs of Windows bias. Windows-specific tools and patterns (such as PowerShell and Windows Services) are mentioned before or more prominently than their Linux equivalents. Examples for disk preparation and service management are more detailed for Windows (with PowerShell commands and references) than for Linux, which receives less detailed scripting guidance. Some sections, such as directory junctions, focus exclusively on Windows issues. In several places, Windows terminology and tooling are introduced before Linux alternatives, and Linux examples are sometimes less comprehensive or missing.
Recommendations
- Ensure Linux and Windows examples are presented with equal detail and prominence, ideally side-by-side.
- Provide Bash or shell script examples for Linux wherever PowerShell is used for Windows.
- Mention Linux tools (e.g., systemd, fdisk, mkfs) before or alongside Windows tools (e.g., PowerShell, Windows Services) in relevant sections.
- Expand Linux-specific troubleshooting, configuration, and best practices to match the depth of Windows guidance.
- Avoid Windows-first ordering in lists and examples; alternate or group by OS where possible.
- For sections focused on Windows-specific issues (e.g., directory junctions), add parallel Linux guidance or explicitly state the OS scope.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-14 00:00 | #250 | in_progress |
Biased
|
| 2026-01-13 00:00 | #246 | completed |
Biased
|
| 2026-01-12 00:00 | #243 | cancelled |
Biased
|
| 2026-01-11 00:00 | #240 | completed |
Biased
|
| 2026-01-10 00:00 | #237 | completed |
Biased
|
| 2026-01-09 00:34 | #234 | completed |
Biased
|
| 2026-01-08 00:53 | #231 | completed |
Biased
|
| 2026-01-06 18:15 | #225 | cancelled |
 Clean
|
| 2025-08-17 00:01 | #83 | cancelled |
Clean
|
| 2025-07-13 21:37 | #48 | completed |
Biased
|
| 2025-07-09 13:09 | #3 | cancelled |
Clean
|
| 2025-07-08 04:23 | #2 | cancelled |
Biased
|