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
missing_linux_example
Summary
The documentation demonstrates a mild Windows bias. In the section about parameter naming conflicts, only PowerShell (specifically the New-AzResourceGroupDeployment cmdlet) is discussed, with no mention of equivalent Azure CLI or Linux-native tooling. In the resources section, links to Windows VM connection methods are listed before Linux, and two out of three links are Windows-specific. There are no Linux shell or Azure CLI examples for template deployment or parameter handling, and no mention of Linux tools or workflows.
Recommendations
- Include Azure CLI examples alongside or before PowerShell examples when discussing template deployment and parameter handling.
- Mention Linux-native tools and workflows (e.g., bash, az CLI) in sections that currently only reference PowerShell or Windows tools.
- When listing links for connecting to VMs, alternate the order or group Windows and Linux resources equally, and ensure parity in detail and prominence.
- Add explicit Linux/CLI examples for common tasks such as deploying templates, handling parameters, and resolving naming conflicts.
- Reference cross-platform editors and tools (e.g., Visual Studio Code) in a way that highlights their availability on Linux and macOS, not just Windows.
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
|