Document Details

Template Specs
Home / Scan #41 / 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
powershell_heavy
windows_first
Summary
The documentation provides both PowerShell and Azure CLI examples for all command-line operations, which is positive for cross-platform parity. However, PowerShell examples are consistently presented first, and the narrative often refers to 'PowerShell or CLI' (rather than 'CLI or PowerShell'), subtly prioritizing Windows-centric tooling. There are no explicit Linux-only examples or references to Linux-specific workflows, shells, or file system conventions. No Windows-only tools are used, but the ordering and language suggest a mild Windows/PowerShell bias.
Recommendations
  • Alternate the order of PowerShell and CLI examples throughout the documentation, or present CLI examples first in some sections to avoid implicit prioritization.
  • Use more neutral phrasing such as 'Azure CLI or PowerShell' instead of always 'PowerShell or CLI'.
  • Explicitly mention that Azure CLI commands work cross-platform (Windows, Linux, macOS) and consider adding a note or example showing CLI usage in a Linux shell (e.g., bash).
  • Where file paths are shown (e.g., './mainTemplate.json'), clarify that the syntax is compatible with both Windows and Linux/macOS, or provide both styles if relevant.
  • Consider including a brief section or note on cross-platform compatibility, especially for users on Linux or macOS.
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 `
  -TemplateSpecId $id `
  -ResourceGroupName demoRG `
  -StorageAccountType Standard_GRS

New-AzTemplateSpec -Name storageSpec -Version 1.0a -ResourceGroupName templateSpecsRg -Location westus2 -TemplateFile ./mainTemplate.json

Get-AzTemplateSpec

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-AzResourceGroupDeployment `
  -TemplateSpecId $id `
  -ResourceGroupName demoRG `
  -TemplateParameterFile ./mainTemplate.parameters.json

New-AzTemplateSpec `
  -Name storageSpec `
  -Version 1.0a `
  -ResourceGroupName templateSpecsRg `
  -Location westus2 `
  -TemplateFile ./mainTemplate.json `
  -Tag @{Dept="Finance";Environment="Production"}

Set-AzTemplateSpec `
  -Name storageSpec `
  -Version 1.0a `
  -ResourceGroupName templateSpecsRg `
  -Location westus2 `
  -TemplateFile ./mainTemplate.json `
  -Tag @{Dept="Finance";Environment="Production"}