Document Details

Quickstart Create Template Specs
Home / Scan 48 / 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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Bias Types:
⚠️ windows_first
⚠️ missing_linux_example
⚠️ windows_tools
Summary:
The documentation demonstrates a Windows bias by consistently using Windows-style file paths (e.g., C:\templates\main.bicep) in all examples, regardless of shell. There are no Linux/macOS path examples or notes for cross-platform users. Additionally, references to Visual Studio Code and PowerShell are prominent, and the only role-based access control tutorial linked is for PowerShell. While Azure CLI is included (which is cross-platform), the lack of Linux/macOS-specific guidance and the default to Windows conventions may confuse or exclude non-Windows users.
Recommendations:
  • Provide both Windows (C:\path\to\file) and Linux/macOS (/home/user/path/to/file or ~/path/to/file) path examples in all command samples.
  • Add notes or tabs clarifying file path differences between platforms.
  • Include links to role-based access control tutorials for Azure CLI and/or portal, not just PowerShell.
  • Mention that Azure CLI and Bicep are cross-platform and provide installation/use guidance for Linux/macOS.
  • Where PowerShell is referenced, clarify that it is available on Linux/macOS, or provide Bash equivalents where appropriate.
  • Review all code snippets and instructions to ensure they are not Windows-centric by default.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased

Flagged Code Snippets

New-AzResourceGroupDeployment ` -TemplateSpecId $id ` -ResourceGroupName storageRG ` -storageAccountType Standard_GRS
New-AzTemplateSpec ` -Name storageSpec ` -Version "2.0" ` -ResourceGroupName templateSpecRG ` -Location westus2 ` -TemplateFile "C:\templates\main.bicep"
New-AzResourceGroupDeployment ` -ResourceGroupName storageRG ` -TemplateFile "C:\templates\storage.bicep"
New-AzResourceGroupDeployment ` -ResourceGroupName templateSpecRG ` -TemplateFile "C:\templates\main.bicep"
New-AzResourceGroup ` -Name storageRG ` -Location westus2
az deployment group create \ --resource-group templateSpecRG \ --template-file "C:\templates\main.bicep"
New-AzResourceGroupDeployment ` -ResourceGroupName storageRG ` -TemplateFile "C:\templates\storage.bicep"
(Get-AzContext).Subscription.Id
New-AzResourceGroup ` -Name storageRG ` -Location westus2
New-AzResourceGroupDeployment ` -ResourceGroupName storageRG ` -TemplateFile "C:\templates\storage.bicep"
$id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "2.0").Versions.Id
Remove-AzResourceGroup -Name "templateSpecRG" Remove-AzResourceGroup -Name "storageRG"
New-AzResourceGroupDeployment ` -ResourceGroupName templateSpecRG ` -TemplateFile "C:\templates\main.bicep"
New-AzTemplateSpec ` -Name storageSpec ` -Version "1.0" ` -ResourceGroupName templateSpecRG ` -Location westus2 ` -TemplateFile "C:\templates\main.bicep"
az ts create \ --name storageSpec \ --version "1.0" \ --resource-group templateSpecRG \ --location westus2 \ --template-file "C:\templates\main.bicep"
$id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "1.0").Versions.Id
New-AzResourceGroupDeployment ` -TemplateSpecId $id ` -ResourceGroupName storageRG ` -storageAccountType Standard_GRS
$id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "2.0").Versions.Id
az ts create \ --name storageSpec \ --version "2.0" \ --resource-group templateSpecRG \ --location westus2 \ --template-file "C:\templates\main.bicep"
Remove-AzResourceGroup -Name "templateSpecRG" Remove-AzResourceGroup -Name "storageRG"