Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_first
Summary
The documentation demonstrates a notable Windows bias in the section on copying keys between key vaults, where only a PowerShell script is provided with no equivalent Bash, Azure CLI, or Linux-native instructions. The script requires PowerShell and specific modules, which are most easily available on Windows. Additionally, references to disk encryption link first to Windows VM guides, and Windows update instructions are given before Linux guidance. No Linux/macOS alternatives for the key copy step are described.
Recommendations
- Provide equivalent instructions and scripts for Linux/macOS users, such as Bash or Azure CLI commands to copy keys between key vaults.
- Explicitly mention how Linux/macOS users can install and use PowerShell Core, or offer a cross-platform script.
- Ensure that documentation links and examples for disk encryption are balanced between Windows and Linux, or presented together.
- Where possible, use Azure CLI examples, which are cross-platform, instead of PowerShell-only scripts.
Create Pull Request