Document Details

Quickstart Create Template Specs
Home / Scan #41 / 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
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 the shell (PowerShell or Azure CLI). There are no Linux/macOS path examples, and no mention of Linux-specific considerations. The documentation also refers to PowerShell and Azure CLI, but PowerShell is always presented first, and the only editor mentioned is Visual Studio Code. Additionally, the 'Grant access' section links only to a PowerShell-based tutorial.
Recommendations
  • Provide both Windows and Linux/macOS path examples in all command snippets (e.g., use C:\templates\main.bicep and ~/templates/main.bicep).
  • Explicitly mention that file paths should be adapted for the user's operating system.
  • Alternate the order of PowerShell and CLI examples, or present CLI first, as it is cross-platform.
  • Include links to equivalent Linux/macOS tutorials for tasks such as granting access.
  • Clarify that both PowerShell and CLI are available on multiple platforms, but that file path syntax may differ.
  • Consider mentioning other editors (such as Vim, nano, or Sublime Text) in addition to Visual Studio Code.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-07-12 23:44 #41 cancelled Biased Biased
2025-07-12 00:58 #8 cancelled Clean Clean
2025-07-10 05:06 #7 processing Clean Clean

Flagged Code Snippets

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

Remove-AzResourceGroup -Name "storageRG"