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
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for deployment commands and role assignment, but PowerShell is often presented first or equally, which can be interpreted as a slight Windows bias. There are no Linux-specific instructions or examples, and no mention of running these commands in a Linux environment or using Bash. However, Azure CLI is cross-platform and is included, which helps mitigate the bias. There are no exclusive references to Windows-only tools, but the presence and order of PowerShell examples may suggest a preference for Windows users.
Recommendations
  • Ensure that Azure CLI examples are always presented before PowerShell, as CLI is cross-platform and more accessible to Linux users.
  • Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and can be run from Bash or other shells.
  • Where PowerShell examples are given, consider also providing Bash or shell script equivalents for common tasks (e.g., role assignment), or clarify that Azure CLI is the recommended approach for Linux.
  • Add a note or section about running these commands in Cloud Shell, which is platform-agnostic.
  • Review all examples and instructions to ensure there are no implicit assumptions about the user's operating system.
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

### Scope to subscription

To target a subscription within the tenant, add a module. Use the [subscription function](bicep-functions-scope.md#subscription) to set its `scope` property. Provide the subscription ID.

# [PowerShell](#tab/azure-powershell)

For Azure PowerShell, use [New-AzTenantDeployment](/powershell/module/az.resources/new-aztenantdeployment).

### Scope to resource group

To target a resource group within the tenant, add a module. Use the [resourceGroup function](bicep-functions-scope.md#resourcegroup) to set its `scope` property. Provide the subscription ID and resource group name.