Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation is for Azure Disk Encryption on Linux VMs, but almost all automation and scripting examples use PowerShell cmdlets and scripts, which are Windows-centric. Key operations such as listing encrypted VMs, uploading VHDs, and managing secrets in Key Vault are only shown with PowerShell, with no Bash, Azure CLI, or Linux-native alternatives. Even when Linux VM configuration is described, the upload and management steps revert to PowerShell. This creates friction for Linux/macOS users who may not have access to PowerShell or prefer native tools.
Recommendations
- Provide equivalent Azure CLI (az) commands for all PowerShell examples, especially for listing encrypted VMs, uploading VHDs, and managing Key Vault secrets.
- Include Bash script examples for common tasks, such as preparing and uploading encrypted VHDs.
- Mention and demonstrate cross-platform tools (e.g., azcopy for VHD uploads) where possible.
- Order examples so that Linux-native methods (CLI/Bash) are shown before or alongside PowerShell.
- Clarify which steps require PowerShell and suggest alternatives for Linux/macOS users.
Create Pull Request