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
⚠️ missing_linux_example
⚠️ windows_tools
Summary:
The documentation shows a mild Windows bias. In several places, Windows tools and patterns are mentioned first or exclusively, such as Fiddler for network tracing and web.config for logging. Linux alternatives are sometimes mentioned, but often as secondary options or without equal detail. Some logging/tracing instructions are Windows-specific or reference Windows-only platforms (e.g., Windows Phone 8). There is a lack of parity in examples and guidance for Linux environments.
Recommendations:
  • When listing tools for network tracing, present cross-platform options (e.g., tcpdump, Wireshark) before or alongside Windows-specific tools like Fiddler.
  • Provide explicit Linux and macOS examples for enabling server-side and client-side logging, not just web.config (which is Windows/IIS-centric). Include instructions for configuring logging in Linux deployments (e.g., using environment variables, appsettings.json, or systemd).
  • Avoid referencing Windows-only platforms (e.g., Windows Phone 8) without mentioning their irrelevance to Linux users or providing Linux/mobile alternatives.
  • Ensure all code/configuration snippets are applicable to both Windows and Linux, or provide parallel examples for each.
  • Where possible, use neutral language and tool ordering (e.g., 'To collect a network trace, you can use tcpdump (Linux/macOS), Wireshark (cross-platform), or Fiddler (Windows)').
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 ✅ Clean
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

<system.diagnostics> <sources> <source name="Microsoft.Azure.SignalR" switchName="SignalRSwitch"> <listeners> <add name="ASRS" /> </listeners> </source> </sources> <!-- Sets the trace verbosity level --> <switches> <add name="SignalRSwitch" value="Information" /> </switches> <!-- Specifies the trace writer for output --> <sharedListeners> <add name="ASRS" type="System.Diagnostics.TextWriterTraceListener" initializeData="asrs.log.txt" /> </sharedListeners> <trace autoflush="true" /> </system.diagnostics>