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 (a Windows-centric tool) is heavily emphasized, with more detailed scripts and explanations. Some sections (e.g., pre-encrypted VHDs) only show PowerShell examples, and references to using PowerShell sessions are frequent. The use of Windows terminology (e.g., BitLocker, PowerShell cmdlets) and the lack of native Linux shell (bash) or platform-agnostic examples creates friction for Linux/macOS users. In some places, PowerShell is mentioned before CLI, and there are no bash or Linux-native command examples for tasks like mounting disks, formatting, or interacting with Azure APIs outside of CLI/PowerShell.
Recommendations
- Add bash and Linux-native shell examples for all major steps, especially for disk operations and Azure API interactions.
- Provide parity in detail between Azure CLI and PowerShell sections, ensuring CLI examples are as comprehensive as PowerShell ones.
- Avoid assuming users have PowerShell available; clarify when PowerShell is required and offer alternatives for Linux/macOS users.
- Where possible, use platform-agnostic language and tools (e.g., Azure CLI, REST API) before Windows-specific tools.
- Explicitly state when a step or tool is Windows-only, and offer Linux/macOS alternatives.
- Add a section on using Azure REST API or SDKs from Linux for advanced scenarios.
Create Pull Request