Document Details

Template Tutorial Use Conditions
Home / Scan #48 / Template Tutorial Use Conditions
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
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a clear Windows bias. It uses a Windows VM template as the primary example, provides only PowerShell deployment scripts (no Azure CLI or Bash equivalents), and references Windows tools and patterns (e.g., PowerShell, Windows VM Quickstart template) before or instead of Linux alternatives. Linux users are only briefly acknowledged (e.g., Bash in Cloud Shell), but no full Linux/CLI workflow is provided.
Recommendations
  • Provide parallel Azure CLI (az) or Bash script examples for all deployment and cleanup steps, not just PowerShell.
  • Include a Linux VM Quickstart template as an alternative or in addition to the Windows VM template.
  • When referencing Cloud Shell, give equal prominence to Bash and PowerShell, and show both script types.
  • Avoid using only Windows-specific terminology and tools (e.g., PowerShell, Windows VM) in examples and instructions.
  • Add a section or callout for Linux/macOS users, outlining any differences or considerations.
  • Ensure screenshots and walkthroughs are not exclusively based on Windows environments.
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

    https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.compute/vm-simple-windows/azuredeploy.json
    
    $projectName = Read-Host -Prompt "Enter a project name that is used to generate resource group name and resource names"
    $newOrExisting = Read-Host -Prompt "Create new or use existing (Enter new or existing)"
    $location = Read-Host -Prompt "Enter the Azure location (i.e. centralus)"
    $vmAdmin = Read-Host -Prompt "Enter the admin username"
    $vmPassword = Read-Host -Prompt "Enter the admin password" -AsSecureString
    $dnsLabelPrefix = Read-Host -Prompt "Enter the DNS Label prefix"

    $resourceGroupName = "${projectName}rg"
    $storageAccountName = "${projectName}store"

    New-AzResourceGroup -Name $resourceGroupName -Location $location
    New-AzResourceGroupDeployment `
        -ResourceGroupName $resourceGroupName `
        -adminUsername $vmAdmin `
        -adminPassword $vmPassword `
        -dnsLabelPrefix $dnsLabelPrefix `
        -storageAccountName $storageAccountName `
        -newOrExisting $newOrExisting `
        -TemplateFile "$HOME/azuredeploy.json"

    Write-Host "Press [ENTER] to continue ..."