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
Summary
The documentation consistently uses Windows-style file paths (e.g., 'c:\Templates\azuredeploy.json') in all code examples, including Azure CLI sections, without providing Linux/macOS alternatives. There are no explicit Linux/macOS examples or notes about path differences, which may confuse or hinder non-Windows users. While the CLI examples themselves are cross-platform, the path usage and lack of Linux-specific guidance create a Windows-centric bias.
Recommendations
  • Provide both Windows and Linux/macOS file path examples in all code snippets, especially for Azure CLI commands (e.g., use 'c:\Templates\azuredeploy.json' and '~/Templates/azuredeploy.json').
  • Add a note early in the documentation clarifying that file paths should be adjusted for the user's operating system.
  • Wherever file paths are referenced in text or code, use OS-agnostic language or show both formats.
  • Explicitly mention that Azure CLI commands work on Windows, Linux, and macOS, and provide shell-specific guidance if needed.
  • Review screenshots and instructions for any other Windows-specific assumptions (e.g., file explorer references) and provide Linux/macOS equivalents or clarifications.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 00:00 #250 in_progress Biased Biased
2026-01-13 00:00 #246 completed Biased Biased
2026-01-12 00:00 #243 cancelled Biased Biased
2026-01-11 00:00 #240 completed Biased Biased
2026-01-10 00:00 #237 completed Biased Biased
2026-01-09 00:34 #234 completed Biased Biased
2026-01-08 00:53 #231 completed Biased Biased
2026-01-06 18:15 #225 cancelled Clean Clean
2025-09-06 00:00 #103 completed Clean Clean
2025-08-06 00:00 #72 completed Clean Clean
2025-07-26 00:01 #61 completed Clean Clean
2025-07-13 21:37 #48 completed Biased Biased

Flagged Code Snippets

    $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "1.0").Versions.Id
    
    New-AzResourceGroup `
      -Name templateSpecRG `
      -Location westus2
    
    New-AzResourceGroup `
      -Name storageRG `
      -Location westus2
    
    az deployment group create \
      --resource-group templateSpecRG \
      --template-file "c:\Templates\azuredeploy.json"
    
    New-AzResourceGroupDeployment `
      -TemplateSpecId $id `
      -ResourceGroupName storageRG `
      -storageAccountType Standard_GRS