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
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by providing extensive PowerShell examples and cmdlet references, mentioning PowerShell tools and patterns first and in greater detail, and omitting explicit Linux/bash shell examples. While Azure CLI is mentioned, the CLI example is brief and lacks parity with the PowerShell guidance. There is no discussion of Linux-native tools or scripting environments, and the workflow assumes familiarity with Windows/PowerShell conventions.
Recommendations
  • Provide equivalent bash/Azure CLI examples for all PowerShell commands, including how to retrieve object IDs and deploy ARM templates from Linux/macOS environments.
  • List Azure CLI and bash examples before or alongside PowerShell examples to avoid Windows-first ordering.
  • Reference cross-platform tools (e.g., uuidgen for GUID generation) and explain how to perform prerequisite steps (like generating GUIDs or retrieving object IDs) in Linux/macOS shells.
  • Clarify that both PowerShell and CLI commands can be run on any OS, and provide guidance for installing and using Azure CLI and PowerShell Core on Linux/macOS.
  • Add notes or sections specifically addressing Linux/macOS users, including any differences in command syntax or environment setup.
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-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-08-17 00:01 #83 cancelled Clean Clean
2025-07-13 21:37 #48 completed Biased Biased
2025-07-09 13:09 #3 cancelled Clean Clean
2025-07-08 04:23 #2 cancelled Biased Biased

Flagged Code Snippets

$dtlUserRoleDefId = (Get-AzRoleDefinition -Name "DevTest Labs User").Id
$userObjectId = (Get-AzADUser -UserPrincipalName 'email@company.com').Id
New-AzResourceGroupDeployment -Name "MyLabResourceGroup-$(New-Guid)" -ResourceGroupName 'MyLabResourceGroup' -TemplateParameterFile .\azuredeploy.parameters.json -TemplateFile .\azuredeploy.json
New-AzResourceGroupDeployment -Name "MyLabResourceGroup-$(New-Guid)" -ResourceGroupName 'MyLabResourceGroup' -TemplateFile .\azuredeploy.json -roleAssignmentGuid "$(New-Guid)" -labName "MyLab" -principalId "aaaaaaaa-bbbb-cccc-1111-222222222222"
New-AzRoleAssignment -UserPrincipalName <email@company.com> -RoleDefinitionName 'DevTest Labs User' -ResourceName '<Lab Name>' -ResourceGroupName '<Resource Group Name>' -ResourceType 'Microsoft.DevTestLab/labs'