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. In several sections, Windows tools (such as PowerShell cmdlets) are mentioned before or more prominently than their Linux equivalents. Some examples and troubleshooting steps are provided only for Windows (e.g., using PowerShell's Get-Disk), while Linux examples are less detailed or appear after Windows. In some cases, only Windows-specific issues (like directory junctions) are discussed, and Linux alternatives are not equally covered. There are also references to .NET SDKs and Windows configuration properties before mentioning cross-platform or Linux options.
Recommendations
- Ensure that all examples and tooling references are provided for both Windows and Linux, and that Linux examples are as detailed as Windows ones.
- When listing tools or APIs (e.g., PowerShell, Azure CLI), mention cross-platform tools (like Azure CLI) first or alongside Windows-specific tools.
- Provide Linux shell command examples (e.g., using lsblk, fdisk, mkfs) wherever PowerShell examples are given, and ensure parity in the level of detail.
- Include troubleshooting tips and best practices for Linux nodes with the same prominence as for Windows nodes.
- Avoid Windows-specific terminology or patterns (such as .NET classes or Windows Services) without also providing Linux equivalents (such as systemd).
- Where Windows-specific issues are discussed (e.g., directory junctions), add corresponding Linux guidance (e.g., symlinks, mount points) for completeness.
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
|
Flagged Code Snippets
PS C:\Windows\system32> Get-Disk
Number Friendly Name Serial Number HealthStatus OperationalStatus Total Size Partition
Style
------ ------------- ------------- ------------ ----------------- ---------- ----------
0 Virtual HD Healthy Online 30 GB MBR
1 Virtual HD Healthy Online 32 GB MBR
2 Msft Virtu... Healthy Online 64 GB RAW