Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page exhibits a moderate Windows bias in the sections describing customer-managed key setup for confidential VMs. Several steps use PowerShell syntax and Windows-centric tools (e.g., Connect-Graph, New-MgServicePrincipal), and PowerShell is used for scripting even when Azure CLI is available. Linux-specific alternatives for these steps are not provided, and PowerShell commands are shown before or instead of bash equivalents. However, the main VM creation and attestation instructions are Linux-friendly and use bash/Azure CLI.
Recommendations
- Provide bash or Azure CLI-only alternatives for all steps currently shown in PowerShell, especially for service principal creation and Azure Key Vault policy management.
- Explicitly mention how Linux/macOS users can install and use Microsoft Graph SDK (e.g., via dotnet CLI or REST API) or provide REST API equivalents.
- Ensure all scripting examples are shown in both PowerShell and bash where possible, or default to bash/Azure CLI for cross-platform parity.
- Clarify that PowerShell commands can be run in Azure Cloud Shell (which supports bash and PowerShell), but highlight bash as the default for Linux/macOS users.
- Add notes or links to Linux/macOS-specific documentation for steps involving RBAC, service principals, and key management.
Create Pull Request