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
Summary
The documentation is largely platform-neutral, focusing on ARM template best practices. However, there is a notable Windows bias in the section discussing parameter naming conflicts, which references only the PowerShell deployment command and the New-AzResourceGroupDeployment cmdlet. Additionally, in the list of links for connecting to virtual machines, Windows connection guides are listed before Linux, and WinRM (a Windows-specific technology) is mentioned without Linux equivalents. No Linux-specific tools or shell examples are provided, and CLI examples are absent.
Recommendations
- Include Azure CLI examples alongside PowerShell, especially when discussing deployment commands and parameter conflicts.
- When referencing connection guides, list Linux and Windows options equally and avoid putting Windows first.
- Mention cross-platform tools (e.g., Azure CLI, Bash) where relevant, not just Windows/PowerShell tools.
- If discussing parameter conflicts, note how they are handled in Azure CLI and other SDKs, not just PowerShell.
- Add links to Linux/macOS-specific documentation where appropriate.
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
|