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
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell examples for Linux VM disk encryption, but PowerShell (a Windows-centric tool) is heavily emphasized, with more detailed scripts and explanations. Some sections (e.g., pre-encrypted VHDs) only show PowerShell examples, and references to using PowerShell sessions are frequent. The use of Windows terminology (e.g., BitLocker, PowerShell cmdlets) and the lack of native Linux shell (bash) or platform-agnostic examples creates friction for Linux/macOS users. In some places, PowerShell is mentioned before CLI, and there are no bash or Linux-native command examples for tasks like mounting disks, formatting, or interacting with Azure APIs outside of CLI/PowerShell.
Recommendations
  • Add bash and Linux-native shell examples for all major steps, especially for disk operations and Azure API interactions.
  • Provide parity in detail between Azure CLI and PowerShell sections, ensuring CLI examples are as comprehensive as PowerShell ones.
  • Avoid assuming users have PowerShell available; clarify when PowerShell is required and offer alternatives for Linux/macOS users.
  • Where possible, use platform-agnostic language and tools (e.g., Azure CLI, REST API) before Windows-specific tools.
  • Explicitly state when a step or tool is Windows-only, and offer Linux/macOS alternatives.
  • Add a section on using Azure REST API or SDKs from Linux for advanced scenarios.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 01:31 #124 completed Biased Biased
2026-01-13 06:17 #109 completed Biased Biased
2026-01-12 00:00 #101 completed Biased Biased
2026-01-10 00:00 #94 completed Clean Clean
2026-01-09 19:00 #91 completed Clean Clean
2026-01-06 22:28 #80 completed Clean Clean

Flagged Code Snippets