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 Azure PowerShell examples for deploying Bicep files at the management group scope. However, PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and is presented immediately after the CLI example. There are no explicit Linux-specific instructions or examples, and no mention of Bash scripting or Linux shell patterns. The documentation does not mention any platform-specific prerequisites or differences, but the inclusion of PowerShell as a primary example may signal a bias toward Windows users.
Recommendations
  • Clearly indicate that Azure CLI is fully cross-platform and works on Windows, Linux, and macOS.
  • Consider presenting Azure CLI examples first, as it is the most platform-agnostic tool.
  • Add explicit Bash shell examples or notes for Linux users where relevant (e.g., environment variables, file paths).
  • Clarify that PowerShell Core is available cross-platform, but note any differences if applicable.
  • Include a brief section or note on running these commands in Linux/macOS environments, such as using Azure CLI in Bash or Zsh.
  • Avoid implying that PowerShell is the default or preferred method unless there is a technical reason.
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

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

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

### Scope to resource group

You can also target resource groups within the management group. The user deploying the template must have access to the specified scope.

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