Best Practices - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

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 several forms of Windows bias. In multiple sections, Windows-specific tools (such as PowerShell and Windows Services) are mentioned before or more prominently than their Linux equivalents. Some examples are provided only for Windows (e.g., PowerShell cmdlets for disk management), while Linux examples are less detailed or missing. Windows-specific patterns (such as directory junctions, Windows service management, and user/group names) are discussed in depth, sometimes without equivalent Linux guidance. Additionally, links and references to Windows tooling or APIs are often listed before or instead of Linux alternatives.

Recommendations

Ensure that for every Windows-specific example (e.g., PowerShell commands, Windows Services), an equivalent Linux example (e.g., bash commands, systemd services) is provided and given equal prominence.
When listing tools or APIs (such as for discovering EOL dates or managing disks), mention Azure CLI and Linux-native tools before or alongside PowerShell, not after.
Where Windows-specific patterns or pitfalls are discussed (such as directory junctions or user/group names), provide corresponding Linux guidance (e.g., symlinks, Linux user/group management) with equal detail.
In sections where only Windows examples are given (e.g., disk preparation with PowerShell), add equivalent Linux shell script examples.
Review the ordering of examples and references to avoid always listing Windows first; alternate or group by platform.
Explicitly call out platform differences and best practices for both Windows and Linux, especially in areas like service management, file system operations, and user/group handling.

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean

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