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
missing_linux_example
windows_tools
powershell_heavy
Summary
The documentation page exhibits several Windows-centric biases. File paths in all examples use Windows-style (C:\Templates\...), with no mention of Linux or macOS equivalents. PowerShell is presented as a primary tool alongside Azure CLI, and references to Azure PowerShell are frequent, including in prerequisites and role assignment tutorials. There are no Linux shell (bash) or macOS-specific instructions, nor are Linux file paths or environment differences addressed. Known issues are only called out for Windows PowerShell, and the documentation assumes a Windows environment throughout.
Recommendations
  • Provide Linux/macOS file path examples (e.g., /home/user/Templates/createStorageV1.json) alongside Windows paths.
  • Explicitly mention that Azure CLI commands work on Linux/macOS and show sample commands using bash syntax where appropriate.
  • Include notes or tabs for Linux/macOS environments, especially for file operations and environment setup.
  • Reference role assignment tutorials using Azure CLI or bash, not only PowerShell.
  • Call out any cross-platform differences or issues, not just Windows-specific ones.
  • Ensure screenshots and instructions in the portal are not Windows-specific (e.g., avoid showing Windows file dialogs only).
GitHub Create Pull Request

Scan History

Date Scan Status Result
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 Clean Clean
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
    
    New-AzResourceGroup `
      -Name templateSpecRG `
      -Location westus2
    
    az deployment group create \
      --resource-group templateSpecRG \
      --template-file "C:\Templates\createTemplateSepc.json"
    
    New-AzResourceGroup `
      -Name storageRG `
      -Location westus2
    
    az deployment group create \
      --resource-group storageRG \
      --template-file "C:\Templates\deployTemplateSpecV1.json"
    
   New-AzTemplateSpec `
     -Name storageSpec `
     -Version "2.0" `
     -ResourceGroupName templateSpecRG `
     -Location westus2 `
     -TemplateFile "C:\Templates\createStorageV2.json"
   
    New-AzTemplateSpec `
      -Name storageSpec `
      -Version "1.0" `
      -ResourceGroupName templateSpecRG `
      -Location westus2 `
      -TemplateFile "C:\Templates\createStorageV1.json"
    
    New-AzResourceGroupDeployment `
      -ResourceGroupName templateSpecRG `
      -TemplateFile "C:\Templates\createTemplateSpec.json"
    
    az deployment group create \
      --resource-group templateSpecRG \
      --template-file "C:\Templates\createTemplateSpec.json"
    
    Get-AzResource `
      -ResourceGroupName storageRG 
    
    az ts create \
      --name storageSpec \
      --version "1.0" \
      --resource-group templateSpecRG \
      --location "westus2" \
      --template-file "C:\Templates\createStorageV1.json"
    
    New-AzResourceGroupDeployment `
      -ResourceGroupName templateSpecRG `
      -TemplateFile "C:\Templates\createTemplateSpec.json"
    
    Get-AzTemplateSpec `
      -ResourceGroupName templateSpecRG `
      -Name storageSpec
    
    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-AzResourceGroupDeployment `
      -ResourceGroupName storageRG `
      -TemplateFile "C:\Templates\deployTemplateSpecV1.json"
    
    Get-AzResource `
      -ResourceGroupName storageRG 
    
   $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "2.0").Versions.Id
   
   New-AzResourceGroupDeployment `
     -TemplateSpecId $id `
     -ResourceGroupName storageRG `
     -namePrefix "demoaccount"
   
   az ts create \
     --name storageSpec \
     --version "2.0" \
     --resource-group templateSpecRG \
     --location "westus2" \
     --template-file "C:\Templates\createStorageV2.json"
   
    Get-AzTemplateSpec `
      -ResourceGroupName templateSpecRG `
      -Name storageSpec
    
    New-AzResourceGroupDeployment `
      -ResourceGroupName storageRG `
      -TemplateFile "C:\Templates\deployTemplateSpecV2.json"
    
    az deployment group create \
      --resource-group storageRG \
      --template-file "C:\Templates\deployTemplateSpecV2.json"