Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page for enabling disk encryption for Linux clusters in Azure Service Fabric shows a notable Windows bias. PowerShell commands are presented first and in greater detail, with explicit references to Windows filesystem paths (e.g., c:\certificates), and the use of PowerShell-specific cmdlets throughout. While Azure CLI examples are provided, they are often secondary and some instructions (such as certificate handling) assume Windows conventions. There is limited guidance for Linux-native tooling or shell environments, and Linux-specific patterns (e.g., bash scripting, Linux file paths) are not demonstrated.
Recommendations
- Provide Linux-native command examples (e.g., bash scripts) alongside or before PowerShell examples.
- Use Linux file path conventions (e.g., /home/user/certificates) in Linux-focused documentation.
- Include instructions for certificate generation and management using Linux tools (e.g., openssl) rather than only PowerShell.
- Clarify when commands are platform-agnostic (Azure CLI) and when they are Windows-specific (PowerShell), and recommend CLI for cross-platform use.
- Add troubleshooting and validation steps using Linux commands (e.g., lsblk, cryptsetup status) where appropriate.
Create Pull Request