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_tools
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page exhibits moderate Windows bias. Windows-specific tools (PowerShell) and examples are mentioned before or more prominently than Linux equivalents in several sections, especially in disk preparation and troubleshooting. Some sections provide detailed PowerShell guidance for Windows but only brief or less actionable instructions for Linux. In a few cases, Windows-specific patterns (directory junctions, Windows Services) are discussed in detail, while Linux alternatives (systemd, symlinks) are mentioned but not elaborated. There are also instances where Linux examples are missing or less complete compared to Windows.
Recommendations
- Ensure that Linux CLI and scripting examples (e.g., Bash, shell commands) are provided alongside PowerShell for all relevant operations, such as disk preparation and troubleshooting.
- Present Linux and Windows instructions in parallel, giving equal prominence and detail to both platforms.
- Where Windows-specific patterns (e.g., directory junctions, Windows Services) are discussed, provide equivalent Linux guidance (e.g., symlinks, systemd units) with actionable examples.
- Include sample scripts for Linux (e.g., mounting and formatting disks, collecting logs) similar to the PowerShell samples for Windows.
- Avoid presenting Windows tools or examples first unless there is a clear reason; alternate or combine both platforms in examples.
- Review all sections for parity in troubleshooting and operational guidance, ensuring Linux users can follow along without needing to infer steps from Windows instructions.
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
|