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:
⚠️ windows_first
⚠️ powershell_heavy
⚠️ missing_linux_example
Summary:
The documentation provides deployment and management instructions using both Azure CLI and Azure PowerShell, but PowerShell is given equal or sometimes more prominence than CLI, and there are no explicit Linux shell/bash examples or references. The use of PowerShell-specific cmdlets and terminology may be less familiar to Linux users. There is no mention of Linux-specific tools, shell environments, or command-line patterns, and the documentation does not clarify that Azure CLI commands are cross-platform or show them in a Linux context.
Recommendations:
  • Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and show example commands in a bash shell context (e.g., using $ instead of az> or PS> prompts).
  • Add Linux shell-specific notes or examples, such as using bash variables or scripting patterns.
  • Clarify that PowerShell is primarily a Windows tool, and provide guidance for Linux users who may not have PowerShell installed.
  • Where PowerShell is mentioned, ensure that CLI (bash) examples are given equal or greater prominence, and consider listing CLI examples first.
  • Include a section or note on installing and using Azure CLI on Linux, and link to relevant documentation.
  • Avoid using Windows-centric terminology (such as 'local computer' without specifying OS) or clarify when instructions are OS-agnostic.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-12 23:44 #41 in_progress ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

New-AzResourceGroup -Name exampleRG -Location eastus New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -adminUsername "<admin-username>"
# [PowerShell](#tab/PowerShell) [!INCLUDE [Retirement guide](./includes/retirement-banner.md)]