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
Summary
The documentation page exhibits mild Windows bias. Windows and PowerShell-specific patterns are mentioned before Linux equivalents, particularly in the section about parameter naming conflicts with PowerShell cmdlets. The links for connecting to VMs list Windows methods first and in greater detail, with Linux mentioned last. Windows tools (PowerShell, WinRM) are referenced directly, while Linux equivalents (SSH, cloud-init) are not discussed or linked in comparable depth. There is no explicit Linux example for deployment commands or scripting, and no mention of Linux-specific tooling or shell usage.
Recommendations
- Provide Linux/CLI examples alongside or before Windows/PowerShell examples, especially for deployment commands and parameter conflicts.
- Include references and links to Linux tools and patterns (e.g., SSH, cloud-init) when discussing VM connectivity and scripting.
- Ensure parity in documentation depth for both Windows and Linux, such as describing how parameter naming conflicts are handled in Azure CLI or Bicep.
- Add Linux-specific best practices for template deployment and management, including shell scripting and automation.
- Balance the order of presentation so that Linux and Windows are treated equally, avoiding Windows-first ordering.
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
|