Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page exhibits several Windows biases. Many steps, especially those involving Azure AD and Key Vault permissions, use PowerShell commands and Windows-centric tooling (e.g., Microsoft Graph SDK for PowerShell) without offering equivalent Bash or Linux-native alternatives. PowerShell is used for scripting and variable assignment, even though the Azure CLI is cross-platform. Windows tools and patterns (like Out-String, ConvertFrom-Json) are referenced, and the instructions for service principal creation and policy assignment are Windows-first. Linux examples are present for VM creation and attestation, but the overall scripting workflow assumes a Windows/PowerShell environment.
Recommendations
- Provide Bash or Azure CLI-only alternatives for all scripting steps, especially those currently shown only in PowerShell.
- Replace or supplement PowerShell-specific commands (e.g., Out-String, ConvertFrom-Json) with cross-platform equivalents (e.g., jq for JSON parsing in Bash).
- Explicitly mention and demonstrate how to perform prerequisite steps (such as service principal creation and policy assignment) on Linux/macOS environments.
- Ensure that all examples and scripts are runnable in Azure Cloud Shell (Bash) and do not require PowerShell unless strictly necessary.
- Where Windows tools or SDKs are referenced, provide links or instructions for Linux equivalents or clarify cross-platform compatibility.
Create Pull Request