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

Bias Types:
⚠️ powershell_heavy
⚠️ missing_linux_example
⚠️ windows_tools
⚠️ windows_first
Summary:
The documentation page demonstrates a strong Windows bias. All command-line examples use Azure PowerShell cmdlets, with no mention of Azure CLI or Bash equivalents, which are more commonly used on Linux and macOS. The DNS testing example uses nslookup in a Windows PowerShell prompt, and there are no examples using dig or host, which are standard on Linux. The documentation refers to Windows tools and patterns exclusively and does not provide Linux-specific guidance or parity.
Recommendations:
  • Provide Azure CLI (az) command examples alongside or in place of PowerShell for all DNS record creation and web app configuration steps.
  • Include DNS query examples using dig and/or host, which are standard on Linux, in addition to or instead of nslookup.
  • Avoid showing only PowerShell prompts (e.g., 'PS C:\>') and instead use generic shell prompts or show both Windows and Linux terminal examples.
  • Explicitly mention that the steps can be performed from any OS, and provide links or notes for installing required tools on Linux/macOS.
  • Consider restructuring the documentation to present cross-platform examples side-by-side, or default to Azure CLI, which is cross-platform.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-09-11 00:00 #108 completed ✅ Clean
2025-08-11 00:00 #77 completed ✅ Clean
2025-08-10 00:00 #76 completed ✅ Clean
2025-08-09 00:00 #75 completed ✅ Clean
2025-08-08 00:00 #74 completed ✅ Clean
2025-08-07 00:00 #73 completed ✅ Clean
2025-08-06 00:00 #72 completed ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

New-AzDnsRecordSet -ZoneName contoso.com -ResourceGroupName "MyAzureResourceGroup" ` -Name "www" -RecordType "CNAME" -Ttl 600 ` -DnsRecords (New-AzDnsRecordConfig -cname "contoso.azurewebsites.net")
Name : www ZoneName : contoso.com ResourceGroupName : myazureresourcegroup Ttl : 600 Etag : 8baceeb9-4c2c-4608-a22c-229923ee185 RecordType : CNAME Records : {contoso.azurewebsites.net} Tags : {}
PS C:\> nslookup Default Server: Default Address: 192.168.0.1 > www.contoso.com Server: default server Address: 192.168.0.1 Non-authoritative answer: Name: <instance of web app service>.cloudapp.net Address: <ip of web app service> Aliases: www.contoso.com contoso.azurewebsites.net <instance of web app service>.vip.azurewebsites.windows.net > contoso.com Server: default server Address: 192.168.0.1 Non-authoritative answer: Name: contoso.com Address: <ip of web app service> > set type=txt > contoso.com Server: default server Address: 192.168.0.1 Non-authoritative answer: contoso.com text = "contoso.azurewebsites.net"
New-AzDnsRecordSet -ZoneName contoso.com -ResourceGroupName MyAzureResourceGroup ` -Name "@" -RecordType "txt" -Ttl 600 ` -DnsRecords (New-AzDnsRecordConfig -Value "contoso.azurewebsites.net")