Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation page, while focused on Azure Disk Encryption for Linux VMs, exhibits a strong bias towards Windows tooling and PowerShell. All automation and scripting examples for interacting with Azure resources (listing encrypted VMs, uploading VHDs, managing Key Vault secrets, attaching disks) use PowerShell cmdlets, with no Bash/CLI or Azure CLI equivalents provided. The use of PowerShell is pervasive, and Windows-centric tools (e.g., Add-AzVhd) are referenced without Linux alternatives. In several cases, the only way to complete a step is via PowerShell, which is not natively available on most Linux distributions. The Linux-specific instructions are limited to OS-level configuration and encryption setup, but all Azure-side operations are Windows/PowerShell-centric.
Recommendations
- Provide Azure CLI (az) equivalents for all PowerShell cmdlets and scripts, especially for listing encrypted VMs, uploading VHDs, managing Key Vault secrets, and attaching disks.
- Include Bash script examples for interacting with Azure resources, demonstrating parity for Linux users.
- Clearly indicate when a step can be performed using Azure CLI or REST API, and link to relevant documentation.
- Reorder examples so that Linux-native tools (Azure CLI, Bash) are presented before or alongside PowerShell.
- Note any limitations or differences between PowerShell and CLI approaches, and provide guidance for Linux/macOS users.