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 Windows-first bias by presenting Windows command prompt and PowerShell instructions before macOS and Linux equivalents. The use of MSBuild and .csproj scripting is more common in Windows-centric workflows. Visual Studio Code is mentioned as cross-platform, but the primary application example is an ASP.NET Core app, which is historically Windows-centric, though now cross-platform. No Linux-specific tools or patterns are highlighted, and the structure subtly prioritizes Windows users.
Recommendations:
  • Present Linux/macOS and Windows instructions in parallel or randomize their order to avoid always listing Windows first.
  • Include examples using Linux-native build tools or scripting (e.g., bash scripts, Makefiles) alongside MSBuild.
  • Highlight cross-platform compatibility explicitly, and provide more context for Linux users (e.g., file path conventions, shell differences).
  • Where possible, use neutral language and tools (e.g., .NET CLI, Azure CLI) that work identically across platforms.
  • Add troubleshooting tips or notes for Linux-specific issues that may arise in CI/CD pipelines.
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-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

<Target Name="Export file" AfterTargets="Build"> <Message Text="Export the configurations to a temp file. " /> <Exec WorkingDirectory="$(MSBuildProjectDirectory)" Condition="$(ConnectionString) != ''" Command="az appconfig kv export -d file --path $(OutDir)\azureappconfig.json --format json --separator : --connection-string $(ConnectionString)" /> </Target>
$Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"