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
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) are mentioned before or more prominently than their Linux equivalents. Some examples and guidance are provided only for Windows (e.g., using PowerShell cmdlets to enumerate disks), while Linux examples are less detailed or missing. Additionally, certain recommendations (like using pool scope for short tasks) specifically reference Windows nodes, and Windows-specific issues (directory junctions, Windows Services) are discussed in more detail than their Linux counterparts.
Recommendations:
- Ensure that for every Windows/PowerShell example or tool mentioned, a Linux/bash equivalent is provided with equal detail and prominence.
- When listing tools or APIs (e.g., for discovering EOL dates), mention cross-platform options first (such as Azure CLI or REST API), or present both Windows and Linux options together.
- Expand sections that currently only provide Windows-specific guidance (e.g., disk preparation, directory management) to include equivalent Linux commands and best practices.
- Balance the discussion of OS-specific pitfalls (e.g., directory junctions in Windows) with Linux-specific considerations (e.g., symlink handling, systemd service management).
- Where recommendations are OS-specific (such as 'Use pool scope for short tasks on Windows nodes'), clarify if and how they apply to Linux nodes.
- Review for any missing Linux examples, especially in sections where only PowerShell or Windows tools are referenced, and add bash or Linux-native command examples.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-08-17 00:01 | #83 | in_progress | ✅ 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