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. Windows-specific tools (PowerShell) and patterns are mentioned before or more prominently than Linux equivalents in several places, especially in disk preparation and troubleshooting. Some examples and recommendations are Windows-centric, with Linux alternatives provided later or less thoroughly. Certain sections, such as directory junctions and service management, focus on Windows-specific issues or solutions, while Linux guidance is less detailed or omitted.
Recommendations
- Ensure Linux and Windows examples are presented with equal prominence and detail, ideally side-by-side.
- When referencing tools (e.g., PowerShell), also mention equivalent Linux commands (e.g., bash scripts, fdisk, mkfs) in the same context.
- Provide sample scripts for both Windows (PowerShell) and Linux (bash) for common operations such as disk initialization, log collection, and service management.
- Avoid Windows-first ordering in lists and examples; alternate or group by OS where possible.
- Expand Linux-specific troubleshooting and best practices sections to match the depth provided for Windows.
- Where Windows-only issues are discussed (e.g., directory junctions), provide equivalent Linux guidance (e.g., symlinks, mount points) for parity.
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
|