Document Details

Deployment Tutorial Local Template
Home / Scan #41 / Deployment Tutorial Local Template
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
windows_tools
Summary
The documentation generally maintains parity between Azure PowerShell and Azure CLI, and explicitly states that CLI examples are written for Bash (Linux/macOS). However, there is a subtle Windows bias in the ordering and tool recommendations: Windows tools and installation instructions are listed before Linux/macOS equivalents, and Visual Studio Code (a Microsoft product) is recommended as the editor, with no mention of Linux-preferred alternatives. The 'Get tools' section lists PowerShell (primarily a Windows tool) first, and the Azure CLI installation link for Windows precedes those for Linux and macOS.
Recommendations
  • Alternate the order of tool and installation instructions (e.g., list Azure CLI before PowerShell, or rotate the order of OS-specific installation links).
  • Explicitly mention that PowerShell is available cross-platform, or clarify that Bash examples are suitable for Linux/macOS users.
  • Recommend additional editors commonly used on Linux (such as Vim, Emacs, or nano) alongside Visual Studio Code.
  • Ensure that all sections provide equal visibility to Linux/macOS instructions and tools, not just as secondary options.
  • Consider including a short note at the top stating that all instructions are cross-platform unless otherwise noted.
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

Connect-AzAccount

Set-AzContext [SubscriptionID/SubscriptionName]

$projectName = Read-Host -Prompt "Enter a project name that is used to generate resource and resource group names"
$resourceGroupName = "${projectName}rg"

New-AzResourceGroup `
  -Name $resourceGroupName `
  -Location "Central US"

$projectName = Read-Host -Prompt "Enter the same project name"
$templateFile = Read-Host -Prompt "Enter the template file path and file name"
$resourceGroupName = "${projectName}rg"

New-AzResourceGroupDeployment `
  -Name DeployLocalTemplate `
  -ResourceGroupName $resourceGroupName `
  -TemplateFile $templateFile `
  -projectName $projectName `
  -verbose