Best Practices - Document Details

Bias Analysis

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

Date	Scan ID	Status	Bias Status
2025-07-12 23:44	#41	in_progress	❌ Biased
2025-07-12 00:58	#8	cancelled	✅ Clean
2025-07-10 05:06	#7	processing	✅ Clean

Document Details

About This Page

Bias Analysis

Scan History

Flagged Code Snippets