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
missing_linux_example
windows_tools
Summary
The documentation exhibits a notable Windows bias. Windows/PowerShell examples are shown first and exclusively in key sections, such as project creation, directory navigation, and cleanup. The use of PowerShell commands is pervasive, with no equivalent bash or Linux/macOS shell examples provided. Directory paths and project setup instructions consistently use Windows conventions (e.g., C:\msBuildDemo), and the Classic framework example is only relevant to Windows. While the documentation mentions cross-platform NuGet packages and provides some Linux/macOS references for the Bicep CLI, practical step-by-step instructions and code samples are almost entirely Windows-centric.
Recommendations
  • Provide Linux/macOS shell (bash/zsh) equivalents for all PowerShell commands, including directory creation, navigation, and cleanup.
  • Show Linux/macOS directory paths (e.g., /home/user/msBuildDemo) alongside Windows paths.
  • Include explicit instructions for using Visual Studio Code or terminal on Linux/macOS, not just Windows.
  • Add project file examples referencing Azure.Bicep.CommandLine.linux-x64 and Azure.Bicep.CommandLine.osx-x64, not just win-x64.
  • Where tabs are used for .NET versions, also provide tabs for OS-specific instructions (Windows, Linux, macOS).
  • Clarify which steps are OS-agnostic and which require adaptation, and link to relevant cross-platform documentation.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-12 00:00 #99 completed Biased Biased
2026-01-11 06:20 #98 completed Biased Biased
2026-01-10 00:00 #92 completed Clean Clean
2026-01-09 00:00 #87 cancelled Clean Clean
2026-01-06 22:28 #78 completed Clean Clean
2025-12-29 18:00 #48 cancelled Biased Biased
2025-12-15 00:00 #7 completed Clean Clean
2025-12-14 05:05 #6 completed Clean Clean

Flagged Code Snippets