Document Details

Best Practices
Home / Scan #48 / Best Practices
Sad Tux - Windows bias detected
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.
GitHub View on GitHub 📚 View on Microsoft Learn

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) 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.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 00:00 #250 in_progress Biased Biased
2026-01-13 00:00 #246 completed Biased Biased
2026-01-12 00:00 #243 cancelled Biased Biased
2026-01-11 00:00 #240 completed Biased Biased
2026-01-10 00:00 #237 completed Biased Biased
2026-01-09 00:34 #234 completed Biased Biased
2026-01-08 00:53 #231 completed Biased Biased
2026-01-06 18:15 #225 cancelled Clean Clean
2025-08-17 00:01 #83 cancelled Clean Clean
2025-07-13 21:37 #48 completed Biased Biased
2025-07-09 13:09 #3 cancelled Clean Clean
2025-07-08 04:23 #2 cancelled Biased 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