Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation is focused on enabling Azure Disk Encryption for Linux VMs and is generally Linux-centric. However, there is evidence of Windows bias in the form of frequent references to PowerShell and Azure PowerShell cmdlets, with PowerShell examples and quickstarts mentioned alongside (and sometimes before) Azure CLI equivalents. The 'Next steps' section lists both CLI and PowerShell quickstarts, and the terminology table includes 'PowerShell cmdlets' as a primary concept, despite the Linux focus. There are no missing Linux examples or exclusive references to Windows tools, but the prominence of PowerShell may create friction for Linux users who prefer native Linux tooling.
Recommendations
- Prioritize Azure CLI examples and quickstarts before PowerShell in all lists and sections, as CLI is more native to Linux environments.
- Clarify that PowerShell is cross-platform, but emphasize CLI as the recommended approach for Linux users.
- Remove or de-emphasize 'PowerShell cmdlets' from the terminology table unless specifically relevant to Linux users.
- Ensure that all scripts and examples are available in Bash/CLI format, and highlight these as the default for Linux documentation.
- Add a note explaining the differences between CLI and PowerShell usage on Linux, and recommend CLI for most users.
Create Pull Request