Document Details

Quickstart Create Template Specs
Home / Scan #48 / Quickstart Create Template Specs
Sad Tux - Windows bias detected
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

Detected Bias Types
windows_first
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by consistently using Windows-style file paths (e.g., C:\templates\main.bicep) in all CLI and PowerShell examples, and by referencing Windows tools and patterns (such as PowerShell and backslash line continuations) before or instead of Linux equivalents. There are no explicit Linux/macOS shell examples, and the CLI examples use Windows paths and conventions, which may not work on Linux/macOS systems.
Recommendations
  • Provide both Windows and Linux/macOS file path examples (e.g., C:\templates\main.bicep and ~/templates/main.bicep) in all CLI and PowerShell commands.
  • When showing Azure CLI examples, use POSIX-style paths and line continuations (forward slashes and \ or \ for Windows, / for Linux/macOS).
  • Explicitly mention that the examples work on both Windows and Linux/macOS, and highlight any differences (such as variable assignment syntax in Bash vs PowerShell).
  • Add tabs or callouts for Bash (Linux/macOS) shell usage where appropriate, especially for Azure CLI commands.
  • Avoid using only Windows-specific tools or patterns (such as PowerShell) as the primary or first example; alternate or present Bash/Linux examples first in some sections.
  • Clarify in notes or prerequisites that Visual Studio Code and the Bicep extension are cross-platform, and provide installation links for Linux/macOS if available.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-13 06:17 #107 completed Biased Biased
2026-01-12 00:00 #99 completed Biased Biased
2026-01-11 06:20 #98 completed Biased Biased
2026-01-10 00:00 #92 completed Biased Biased
2026-01-09 00:00 #87 cancelled Clean Clean
2026-01-06 22:28 #78 completed Clean Clean
2025-12-29 18:00 #48 cancelled Biased Biased
2025-12-15 00:00 #7 completed Clean Clean
2025-12-14 05:05 #6 completed Clean Clean

Flagged Code Snippets

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

Remove-AzResourceGroup -Name "storageRG"