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
⚠️ missing_linux_example
Summary:
The documentation exhibits a moderate Windows bias. PowerShell examples and references are consistently presented before Azure CLI (cross-platform) examples. The use of PowerShell-specific cmdlets and terminology (e.g., Get-AzContainerRegistry, Publish-AzBicepModule) is prominent, and Windows paths are listed first in local cache examples. There is little to no mention of Linux-specific shell usage, and no explicit Linux shell (bash) or scripting examples are provided. The documentation assumes familiarity with Windows tools and patterns, with Linux and Mac paths only briefly mentioned.
Recommendations:
  • Alternate the order of examples so that Azure CLI (cross-platform) is presented before PowerShell, or present both side-by-side.
  • Include Linux/macOS shell (bash) examples where relevant, especially for scripting or automation scenarios.
  • Provide more detailed Linux and Mac path examples, matching the detail given for Windows.
  • Avoid Windows-centric terminology and tools as the default; clarify that PowerShell is available cross-platform, or provide bash equivalents.
  • Explicitly state that all Azure CLI commands work identically on Linux, macOS, and Windows, and consider adding notes or troubleshooting tips for Linux users.
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

Publish-AzBicepModule -FilePath ./storage.bicep -Target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 -DocumentationUri https://www.contoso.com/exampleregistry.html
Publish-AzBicepModule -FilePath ./storage.bicep -Target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 -DocumentationUri https://www.contoso.com/exampleregistry.html -WithSource
Publish-AzBicepModule -FilePath ./storage.bicep -Target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 -DocumentationUri https://www.contoso.com/exampleregistry.html -WithSource