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
Summary
The documentation consistently assumes or prioritizes Windows as the development environment, especially in the C# and Java sections. Instructions such as 'Open a Windows command prompt' are given without Linux equivalents, and there is no mention of Linux-specific steps or terminal usage. While some commands (like dotnet and npm) are cross-platform, the narrative and explicit instructions are Windows-centric. There are no PowerShell-specific commands, but the use of 'Windows command prompt' and lack of Linux terminal references indicate a Windows-first bias. Linux users are left to infer how to adapt the steps.
Recommendations
  • Explicitly state that all steps are cross-platform where applicable, and provide parallel instructions for Linux (e.g., 'Open a terminal window' instead of 'Open a Windows command prompt').
  • Where commands differ between Windows and Linux (such as path separators or shell commands), provide both versions or use cross-platform syntax.
  • Include screenshots or notes for Linux environments, especially when referencing file paths or environment variables.
  • Avoid language that assumes Windows as the default (e.g., 'on your Windows-based machine'); instead, use 'on your development machine' and clarify OS-specific differences as needed.
  • For Java and C# sections, mention that the SDKs and tools work on Linux and provide any necessary installation or usage notes for Linux users.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 00:00 #250 in_progress Clean Clean
2026-01-13 00:00 #246 completed Clean Clean
2026-01-11 00:00 #240 completed Clean Clean
2026-01-10 00:00 #237 completed Clean Clean
2026-01-09 00:34 #234 completed Clean Clean
2026-01-08 00:53 #231 completed Clean Clean
2026-01-06 18:15 #225 cancelled Clean Clean
2025-09-15 00:00 #112 completed Clean Clean
2025-08-17 00:01 #83 cancelled Clean Clean
2025-07-13 21:37 #48 completed Clean Clean
2025-07-12 23:44 #41 cancelled Biased Biased
2025-07-09 13:09 #3 cancelled Clean Clean
2025-07-08 04:23 #2 cancelled Biased Biased

Flagged Code Snippets

1. To create an individual enrollment for your TPM device, run the following command (include the quotes around the command arguments):

     
1. Open the file *\src\main\java\samples\com\microsoft\azure\sdk\iot\ServiceEnrollmentSample.java* in an editor.

1. Replace `[Provisioning Connection String]` with the connection string that you copied in [Get the connection string for your provisioning service](#get-the-connection-string-for-your-provisioning-service).