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\azuredeploy.json') in all CLI and PowerShell examples, without providing Linux/macOS alternatives. There are no explicit Linux/macOS shell examples, and the only variable assignment example for Azure CLI uses Bash syntax but still references Windows paths. Additionally, references to PowerShell and Windows-specific tools are prominent, and Linux equivalents or considerations are not mentioned.
Recommendations
  • Provide both Windows and Linux/macOS file path examples (e.g., 'c:\Templates\azuredeploy.json' and '~/Templates/azuredeploy.json') in all CLI and PowerShell code blocks.
  • Explicitly mention that the Azure CLI commands work cross-platform and show Bash/zsh and PowerShell syntax where relevant.
  • Add notes or tabs for Linux/macOS users, especially for file paths and environment-specific behaviors.
  • When referencing PowerShell, clarify that Azure PowerShell is available on Linux/macOS and provide installation links for those platforms.
  • Avoid assuming a Windows directory structure in instructions and screenshots; use neutral or dual examples.
  • Where possible, provide shell-agnostic variable assignment examples or clarify differences between Bash and PowerShell.
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-AzResourceGroup `
      -Name templateSpecRG `
      -Location westus2
    
    New-AzResourceGroup `
      -Name storageRG `
      -Location westus2
    
    New-AzResourceGroup `
      -Name storageRG `
      -Location westus2
    
   New-AzResourceGroupDeployment `
     -TemplateSpecId $id `
     -ResourceGroupName storageRG `
     -namePrefix "demoaccount"
   
    New-AzResourceGroupDeployment `
      -ResourceGroupName templateSpecRG `
      -TemplateFile "c:\Templates\azuredeploy.json"
    
    New-AzResourceGroupDeployment `
      -ResourceGroupName storageRG `
      -TemplateFile "c:\Templates\storage.json"
    
    New-AzResourceGroup `
      -Name templateSpecRG `
      -Location westus2
    
    New-AzTemplateSpec `
      -Name storageSpec `
      -Version "1.0" `
      -ResourceGroupName templateSpecRG `
      -Location westus2 `
      -TemplateFile "c:\Templates\azuredeploy.json"
    
    az ts create \
      --name storageSpec \
      --version "1.0" \
      --resource-group templateSpecRG \
      --location "westus2" \
      --template-file "c:\Templates\azuredeploy.json"
    
    New-AzResourceGroupDeployment `
      -ResourceGroupName templateSpecRG `
      -TemplateFile "c:\Templates\azuredeploy.json"
    
    az deployment group create \
      --resource-group templateSpecRG \
      --template-file "c:\Templates\azuredeploy.json"
    
    $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-AzResourceGroupDeployment `
      -ResourceGroupName storageRG `
      -TemplateFile "c:\Templates\storage.json"
    
    az deployment group create \
      --resource-group storageRG \
      --template-file "c:\Templates\storage.json"
    
   New-AzTemplateSpec `
     -Name storageSpec `
     -Version "2.0" `
     -ResourceGroupName templateSpecRG `
     -Location westus2 `
     -TemplateFile "c:\Templates\azuredeploy.json"
   
   $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\azuredeploy.json"
   
    az deployment group create \
      --resource-group templateSpecRG \
      --template-file "c:\Templates\azuredeploy.json"
    
    az deployment group create \
      --resource-group storageRG \
      --template-file "c:\Templates\storage.json"