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
⚠️ windows_tools
Summary:
The documentation demonstrates a mild Windows bias. PowerShell is mentioned before Azure CLI in both prerequisites and command examples. Additionally, Windows-centric tools and patterns (such as PowerShell cmdlets like Get-AzSubscription, Get-AzADUser, and Get-AzADServicePrincipal) are referenced in parameter descriptions, with no Linux/CLI alternatives provided. However, Azure CLI examples are present alongside PowerShell, and there are no explicit missing Linux examples for the core deployment steps.
Recommendations:
  • Alternate the order of PowerShell and Azure CLI examples throughout the documentation, or present Azure CLI first in some sections to balance exposure.
  • When referencing how to obtain values (such as tenantId or objectId), provide both PowerShell and Azure CLI commands (e.g., az account show, az ad user show) so Linux/macOS users have clear guidance.
  • Clarify that both Azure CLI and PowerShell are cross-platform, but highlight CLI as the default for Linux/macOS users.
  • Where possible, avoid referencing Windows-specific tools or patterns exclusively in parameter descriptions; always include CLI equivalents.
  • Consider adding a short section or note for Linux/macOS users, confirming that all steps are supported on their platforms and linking to relevant installation guides.
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

Flagged Code Snippets

New-AzTemplateSpec ` -name keyvaultspec ` -version 1 ` -ResourceGroupName templateSpecRG ` -location westus2 ` -templatefile keyvault.json ` -UIFormDefinitionFile keyvaultform.json