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 exhibits a Windows-first bias, particularly in the ordering and emphasis of examples for setting environment variables. Windows command prompt and PowerShell instructions are presented before macOS and Linux, and PowerShell is given its own dedicated section. The build script example uses Windows-style path separators (\) in the MSBuild XML, which may not work on Linux/macOS. Visual Studio Code is mentioned as cross-platform, but the primary application example is for ASP.NET Core, which is more common on Windows. There are no Linux-specific troubleshooting notes or parity checks for the build script.
Recommendations:
  • Present Linux/macOS and Windows instructions in parallel tabs or alternate the order to avoid always listing Windows first.
  • Provide explicit notes or examples for Linux/macOS path separators in the MSBuild script (e.g., use $(OutDir)/azureappconfig.json or document cross-platform compatibility).
  • Include troubleshooting tips or caveats for running the build and export steps on Linux/macOS, especially regarding file paths and shell differences.
  • Ensure that all CLI and scripting examples are tested and confirmed to work on Linux and macOS, not just Windows.
  • Consider adding a non-Windows-centric application example (such as a .NET app running on Linux) to demonstrate true cross-platform support.
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 ConnectionString "<connection-string-of-your-app-configuration-store>"
$Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
<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>