Document Details

Template Specs
Home / Scan 41 / 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
⚠️ powershell_heavy
⚠️ windows_tools
Summary:
The documentation consistently presents Azure PowerShell (a Windows-centric tool) examples before Azure CLI, and in some sections, PowerShell is mentioned as a primary integration point (e.g., 'integrate the template spec into an existing deployment process such as a PowerShell script'). There is a general assumption of PowerShell usage, and no explicit mention of Linux shell or scripting environments. While Azure CLI is cross-platform, the documentation does not provide any Linux- or Bash-specific context or examples, nor does it mention Linux-native tools or scripting patterns. There are no examples or guidance tailored to Linux users, and PowerShell is sometimes referenced as the default automation tool.
Recommendations:
  • Alternate the order of PowerShell and Azure CLI examples or present Azure CLI first, as it is cross-platform and more familiar to Linux users.
  • Explicitly mention that Azure CLI commands work in Bash, zsh, and other Linux shells, and provide example shell commands (e.g., export variables, use of $() for command substitution).
  • Where scripting or automation is discussed, include references to Bash scripts or Linux automation pipelines alongside PowerShell.
  • Avoid language that assumes PowerShell as the default scripting tool; instead, refer to 'automation scripts' or 'shell scripts' generically.
  • Add a short section or note highlighting Linux compatibility and any Linux-specific considerations for template specs.
  • If possible, provide at least one end-to-end example using Bash scripting to create, deploy, and manage template specs.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-07-12 23:44 #41 in_progress ❌ Biased
2025-07-12 00:58 #8 cancelled ✅ Clean
2025-07-10 05:06 #7 processing ✅ Clean

Flagged Code Snippets

Get-AzTemplateSpec
New-AzResourceGroupDeployment ` -TemplateSpecId $id ` -ResourceGroupName demoRG ` -StorageAccountType Standard_GRS
New-AzResourceGroupDeployment ` -TemplateSpecId $id ` -ResourceGroupName demoRG ` -TemplateParameterFile ./mainTemplate.parameters.json
New-AzTemplateSpec -Name storageSpec -Version 1.0a -ResourceGroupName templateSpecsRg -Location westus2 -TemplateFile ./mainTemplate.bicep
Get-AzTemplateSpec -ResourceGroupName templateSpecsRG -Name storageSpec
$id = "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/templateSpecsRG/providers/Microsoft.Resources/templateSpecs/storageSpec/versions/1.0a" New-AzResourceGroupDeployment ` -TemplateSpecId $id ` -ResourceGroupName demoRG
$id = (Get-AzTemplateSpec -Name storageSpec -ResourceGroupName templateSpecsRg -Version 1.0a).Versions.Id New-AzResourceGroupDeployment ` -ResourceGroupName demoRG ` -TemplateSpecId $id
New-AzTemplateSpec ` -Name storageSpec ` -Version 1.0a ` -ResourceGroupName templateSpecsRg ` -Location westus2 ` -TemplateFile ./mainTemplate.bicep ` -Tag @{Dept="Finance";Environment="Production"}
Set-AzTemplateSpec ` -Name storageSpec ` -Version 1.0a ` -ResourceGroupName templateSpecsRg ` -Location westus2 ` -TemplateFile ./mainTemplate.bicep ` -Tag @{Dept="Finance";Environment="Production"}