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 several forms of Windows bias. Windows-specific tools (e.g., PowerShell) are mentioned before or more prominently than Linux equivalents, especially for discovering image and VM SKU EOL dates and preparing data disks. Examples for Windows (such as PowerShell commands) are given in detail, while Linux examples are fewer and less detailed. In some cases, Windows patterns (directory junctions, Windows Services, autouser accounts) are discussed at length, while Linux alternatives are only briefly mentioned or omitted. This prioritization may make it harder for Linux users to find relevant guidance.
Recommendations
- Provide Linux CLI or shell script examples alongside PowerShell examples wherever Windows commands are shown.
- Mention Linux tools (e.g., bash, systemd, lsblk, fdisk) before or alongside Windows tools, not after.
- Ensure Linux-specific patterns (e.g., symlinks, systemd services, disk mounting) are described with equal detail and clarity as Windows equivalents.
- Where Windows-specific features (like directory junctions or autouser accounts) are discussed, add parallel Linux guidance (e.g., symlinks, user management).
- For API and CLI references, show both az CLI and bash usage, not just PowerShell.
- Add more Linux-focused troubleshooting and operational tips, especially for common scenarios like disk management, service setup, and log collection.
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
|