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 is emphasized throughout, with more detailed scripts and explanations. Windows-centric tools and terminology (PowerShell cmdlets, Windows flags, references to BitLocker and Windows disk operations) are used extensively, sometimes even in Linux-specific contexts. In several places, PowerShell examples are presented before CLI, and some sections (e.g., pre-encrypted VHD) use Windows flags or lack explicit Linux CLI parity. There are also minor instances of Windows terminology in template instructions and backup/restore references.
Recommendations
- Ensure CLI examples are as detailed and prominent as PowerShell examples, especially for Linux scenarios.
- Remove or clarify Windows-specific flags (e.g., '-Windows' in Set-AzVMOSDisk) when describing Linux workflows.
- Add explicit Linux shell commands for disk operations (e.g., formatting, mounting) alongside PowerShell scripts.
- Review template instructions to ensure Linux terminology is used and avoid references to Windows VMs in Linux sections.
- Where PowerShell is referenced, clarify its cross-platform availability or provide equivalent bash/CLI instructions.
- Consider reordering sections so CLI examples appear before PowerShell for Linux-focused documentation.
Create Pull Request