Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page exhibits moderate Windows bias, especially in the section on creating confidential VMs with customer-managed keys. Several critical steps use PowerShell syntax and Windows-specific tooling (e.g., Connect-Graph, New-MgServicePrincipal), with no equivalent Linux/bash examples provided. This creates friction for Linux/macOS users, who may not have access to PowerShell or Microsoft Graph PowerShell SDK. Additionally, PowerShell commands are presented before or instead of bash alternatives, and some steps assume a Windows environment. The attestation section is Linux-focused, but the earlier VM creation steps lack Linux parity.
Recommendations
- Provide bash/Azure CLI equivalents for all PowerShell commands, especially those involving Microsoft Graph and service principal creation.
- Clearly indicate which steps require Windows/PowerShell and offer alternative instructions for Linux/macOS users.
- Add notes or links to cross-platform tools or REST API equivalents for steps currently requiring PowerShell.
- Ensure that Linux/macOS users can complete all critical tasks without needing Windows tools.
- Reorder examples so that cross-platform or Linux/bash instructions are shown first or alongside Windows/PowerShell examples.
Create Pull Request