Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page for enabling disk encryption for Linux clusters in Azure Service Fabric exhibits several Windows-centric biases. PowerShell commands are presented first and in greater detail, with explicit references to Windows file paths (e.g., 'c:\certificates'), and the use of PowerShell-specific cmdlets throughout. Azure CLI examples are provided, but often as secondary or 'equivalent' commands, and they also use Windows-style paths. There is minimal coverage of Linux-native tooling or shell scripting, and no examples using bash or Linux file system conventions. The documentation assumes familiarity with PowerShell and Windows patterns, which may create friction for Linux/macOS users.
Recommendations
- Provide Linux-first examples, using bash shell and Linux file paths (e.g., '/home/user/certificates') in CLI commands.
- Include step-by-step instructions for Linux environments, such as certificate generation using OpenSSL and file management in Linux.
- Avoid presenting PowerShell commands before CLI or bash examples; alternate or parallelize examples for both platforms.
- Clarify which commands are platform-agnostic (Azure CLI) and which are Windows-specific (PowerShell), and recommend CLI for cross-platform use.
- Add notes or sections for Linux/macOS users highlighting any differences or additional steps required.
- Remove or supplement Windows-specific references (e.g., 'c:\templates') with Linux equivalents.
Create Pull Request