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 in the 'Build and run the app locally' section by presenting Windows Command Prompt and PowerShell commands before the Linux/macOS equivalent. The use of 'setx' (a Windows-specific tool) and explicit mention of Windows PowerShell further reinforce this bias. Although Linux/macOS commands are provided, they are listed after the Windows examples, and the command prompt syntax is used for Maven and curl commands, which may be confusing for non-Windows users.
Recommendations:
  • Present Linux/macOS and Windows instructions in parallel or in separate, clearly labeled sections to ensure equal visibility.
  • Avoid using Windows-specific tools (like 'setx') without providing equivalent Linux/macOS alternatives (e.g., 'export' or instructions for setting persistent environment variables).
  • Use neutral shell syntax (e.g., '$' for bash) for cross-platform commands like Maven and curl, or provide both Windows and Linux/macOS command examples.
  • Consider starting with Linux/macOS examples or alternating the order in which platforms are presented to avoid implicit prioritization of Windows.
  • Add explicit notes or callouts for platform-specific steps to help users quickly find relevant instructions.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-07-12 23:44 #41 in_progress ❌ Biased
2025-07-12 00:58 #8 cancelled ✅ Clean
2025-07-10 05:06 #7 processing ✅ Clean
2025-07-09 23:22 #6 cancelled ✅ Clean

Flagged Code Snippets

setx APP_CONFIGURATION_ENDPOINT "<endpoint-of-your-app-configuration-store>"
$Env:APP_CONFIGURATION_ENDPOINT = "<endpoint-of-your-app-configuration-store>"