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
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 Status Result
2026-01-14 00:00 #250 in_progress Biased Biased
2026-01-13 00:00 #246 completed Biased Biased
2026-01-12 00:00 #243 cancelled Biased Biased
2026-01-11 00:00 #240 completed Biased Biased
2026-01-10 00:00 #237 completed Biased Biased
2026-01-09 00:34 #234 completed Biased Biased
2026-01-08 00:53 #231 completed Biased Biased
2026-01-06 18:15 #225 cancelled Clean Clean
2025-08-17 00:01 #83 cancelled Clean Clean
2025-07-13 21:37 #48 completed Biased 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