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 page is largely platform-neutral, focusing on ARM template best practices. However, there is a notable Windows bias in the 'Parameters' section, where PowerShell deployment command conflicts are discussed in detail, referencing the New-AzResourceGroupDeployment cmdlet and its parameter naming. Additionally, in the 'Resources' section, links to Windows VM connection methods are listed before Linux equivalents, and WinRM setup is mentioned explicitly for Windows. No Linux shell or CLI examples are provided, and Windows tools are referenced before Linux alternatives.
Recommendations
- Include examples and discussion for deploying ARM templates using Azure CLI (az deployment), especially for Linux/macOS users.
- When discussing parameter naming conflicts, also mention how Azure CLI handles such cases, not just PowerShell.
- In the VM connection section, present Linux connection methods (SSH, az vm ssh) before or alongside Windows methods, and provide parity in detail.
- Reference cross-platform tools (e.g., Visual Studio Code, Azure CLI) equally, and avoid assuming PowerShell as the default.
- Add explicit Linux/macOS command-line examples where relevant, especially in sections discussing deployment commands.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-12 00:00 | #99 | completed |
Biased
|
| 2026-01-11 06:20 | #98 | completed |
Biased
|
| 2026-01-10 00:00 | #92 | completed |
 Clean
|
| 2026-01-09 00:00 | #87 | cancelled |
Clean
|
| 2026-01-06 22:28 | #78 | completed |
Clean
|
| 2025-12-29 18:00 | #48 | cancelled |
Biased
|
| 2025-12-15 00:00 | #7 | completed |
Clean
|
| 2025-12-14 05:05 | #6 | completed |
Clean
|