Document Details
Quickstart Create Template Specs
❌
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
Bias Types:
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation consistently uses Windows-style file paths (e.g., 'c:\Templates\azuredeploy.json') in all code examples, including Azure CLI sections, without providing Linux/macOS alternatives. There are no explicit Linux/macOS examples or notes about path differences, which may confuse or hinder non-Windows users. While the CLI examples themselves are cross-platform, the path usage and lack of Linux-specific guidance create a Windows-centric bias.
Recommendations:
- Provide both Windows and Linux/macOS file path examples in all code snippets, especially for Azure CLI commands (e.g., use 'c:\Templates\azuredeploy.json' and '~/Templates/azuredeploy.json').
- Add a note early in the documentation clarifying that file paths should be adjusted for the user's operating system.
- Wherever file paths are referenced in text or code, use OS-agnostic language or show both formats.
- Explicitly mention that Azure CLI commands work on Windows, Linux, and macOS, and provide shell-specific guidance if needed.
- Review screenshots and instructions for any other Windows-specific assumptions (e.g., file explorer references) and provide Linux/macOS equivalents or clarifications.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-09-06 00:00 | #103 | completed | ✅ Clean |
| 2025-08-06 00:00 | #72 | completed | ✅ Clean |
| 2025-07-26 00:01 | #61 | completed | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |
Flagged Code Snippets
New-AzResourceGroup `
-Name templateSpecRG `
-Location westus2
New-AzResourceGroup `
-Name storageRG `
-Location westus2
az deployment group create \
--resource-group templateSpecRG \
--template-file "c:\Templates\azuredeploy.json"
New-AzResourceGroupDeployment `
-TemplateSpecId $id `
-ResourceGroupName storageRG `
-storageAccountType Standard_GRS
$id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "1.0").Versions.Id