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 (e.g., PowerShell) are referenced multiple times, sometimes before or in greater detail than their Linux equivalents. Examples for disk preparation and troubleshooting are more detailed for Windows (PowerShell cmdlets and scripts), while Linux instructions are present but less emphasized and sometimes lack concrete command examples. Windows-specific patterns (directory junctions, Windows Services) are discussed in dedicated sections, whereas Linux equivalents (systemd, symlinks) are mentioned but not explored as thoroughly. In some cases, Windows tooling is listed first or exclusively, and Linux users may need to infer or adapt instructions.
Recommendations
- Provide Linux CLI or shell command examples wherever PowerShell is shown for Windows (e.g., disk enumeration, formatting, mounting).
- Ensure Linux tools (e.g., fdisk, mkfs, lsblk) are given equal prominence and detailed usage instructions as Windows/PowerShell equivalents.
- When listing tools or APIs, alternate the order or present both Windows and Linux options together.
- Expand Linux-specific troubleshooting and operational guidance (e.g., handling services with systemd, dealing with symlinks, log collection).
- Add explicit Linux/macOS examples for common tasks, not just references to external articles.
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
|