Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
While the documentation is focused on Azure Disk Encryption for Linux VMs and provides both Azure CLI and PowerShell examples, there is a notable tendency to mention PowerShell cmdlets and workflows first or more prominently in several sections. PowerShell is a Windows-centric tool, and its usage is emphasized alongside CLI, sometimes with more detailed scripts and explanations. In some places, PowerShell is referenced before CLI, and backup/restore instructions often cite PowerShell cmdlets before CLI equivalents. However, Linux users are not blocked from completing any tasks, as CLI examples are present for all major operations.
Recommendations
- Ensure CLI examples are presented before or alongside PowerShell examples, especially in introductory and critical workflow sections.
- Where PowerShell scripts are shown in detail, provide equally detailed CLI command sequences and context.
- Clarify that PowerShell can be run cross-platform (including on Linux/macOS), but highlight CLI as the native choice for Linux users.
- Review backup/restore and prerequisite instructions to ensure CLI commands are not omitted or relegated to secondary status.
- Add explicit guidance for Linux users on choosing between CLI and PowerShell, mentioning that CLI is typically pre-installed or easier to set up on Linux.
Create Pull Request