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.

Bias Analysis

Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation consistently presents Azure PowerShell and Azure CLI examples side-by-side, but PowerShell is always listed first and referenced as a primary tool. There are no explicit Linux-specific instructions, nor are there examples using Bash, native Linux shell scripting, or Linux-specific tooling. The documentation assumes familiarity with PowerShell patterns (e.g., variable assignment, parameter passing) and does not mention platform differences, such as file paths or shell environments. No examples are given for deploying template specs using Bash scripts, nor is there guidance for Linux users regarding prerequisites or environment setup.
Recommendations
  • Alternate the order of PowerShell and CLI examples, or present CLI (which is cross-platform) first to avoid implicit Windows prioritization.
  • Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide Bash script examples for common workflows.
  • Add a section on environment setup for Linux users, including installation instructions for Azure CLI and notes on file path conventions.
  • Where PowerShell syntax is shown, provide equivalent Bash or shell scripting examples for variable assignment and command chaining.
  • Clarify that PowerShell examples are primarily for Windows users, and encourage Linux users to use Azure CLI.
  • Include troubleshooting tips or notes for Linux-specific issues (e.g., file permissions, shell quoting).
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

Get-AzTemplateSpec
$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.json
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
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.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"}