Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation provides extensive PowerShell-based examples and scripts, including certificate management and disk encryption workflows, which are inherently Windows-centric. Many advanced scenarios (KEK, certificate-based authentication) are only shown with PowerShell, and some steps (like certificate handling) use Windows file paths and tools. While Azure CLI examples are present for basic operations, advanced examples and automation scripts are PowerShell-only. There is little to no mention of Linux-native tooling, shell scripting, or cross-platform certificate management, and certificate-based authentication is explicitly stated as unsupported on Linux VMs.
Recommendations
- Provide equivalent Bash/shell scripts for advanced scenarios, especially for KEK setup and disk encryption extension management.
- Include Linux-native certificate management instructions (e.g., using OpenSSL, PEM files, and Linux file paths) for certificate-based workflows.
- Clarify which steps are cross-platform and which are Windows-only, and offer alternative approaches for Linux users where possible.
- Reorder examples so that Azure CLI (cross-platform) instructions are presented before PowerShell, or at least in parallel.
- Explicitly state limitations for Linux users earlier in the document, and link to Linux-specific guidance or workarounds.
Create Pull Request