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 a moderate Windows bias. Windows-specific tools (PowerShell) and patterns are mentioned first or exclusively in several places, such as disk preparation and troubleshooting. PowerShell is presented as the default for certain operations, and Windows-specific advice (directory junctions, Windows Services) is given more detail or appears before Linux equivalents. Linux examples are sometimes present but less detailed or appear after Windows ones.
Recommendations
- Ensure Linux and Windows examples are provided side-by-side for all operational procedures (e.g., disk preparation, troubleshooting).
- Present CLI and Linux-native tools (e.g., bash, lsblk, systemd) before or alongside PowerShell, not after.
- Expand Linux-specific guidance to match the detail given for Windows (e.g., troubleshooting, service management, file cleanup).
- Avoid presenting Windows tools or patterns as the default; use neutral language and order.
- Where PowerShell is referenced, also provide equivalent Azure CLI or bash script examples.
- Add explicit Linux troubleshooting steps and common issues, matching the coverage for Windows.
- Review all sections for parity in recommendations, examples, and terminology for both platforms.
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
|