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 mentioned before or more prominently than Linux equivalents in several places, such as for discovering image EOL dates and preparing data disks. Windows examples (PowerShell) are provided in detail, while Linux examples are less frequent or less detailed. Some guidance is Windows-centric (directory junctions, Windows Services, user/group names) and appears before or in more detail than Linux alternatives. In some cases, Linux examples or commands are missing or less emphasized.
Recommendations
- Ensure that Linux examples and tools (e.g., Bash, CLI, system utilities) are provided alongside Windows/PowerShell examples, with equal detail and prominence.
- When mentioning tools for tasks (e.g., listing supported images/SKUs), list Azure CLI and Linux-native methods before or alongside PowerShell, not after.
- Provide Linux-specific troubleshooting and best practice sections where Windows-specific advice is given (e.g., file cleanup, service management).
- Avoid Windows-first ordering in lists and examples; alternate or group by OS where possible.
- Where Windows-specific artifacts (users/groups, directory junctions) are discussed, ensure Linux equivalents are also described.
- Expand Linux guidance for areas like disk preparation, log collection, and service management to match the depth of Windows coverage.
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
|