Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page exhibits several Windows biases, particularly in the 'Create Confidential virtual machine using a Customer Managed Key' section. Many steps use PowerShell syntax and Windows-centric tooling (e.g., Connect-Graph, Out-String, ConvertFrom-Json), and PowerShell is used for scripting even when the Azure CLI is available cross-platform. Windows tools and patterns are mentioned before or instead of Linux equivalents, and there is no guidance for performing these steps in a native Linux shell. The attestation section is Linux-focused, but the earlier sections assume a Windows/PowerShell environment.
Recommendations
- Provide equivalent Bash/Linux shell commands for all PowerShell examples, especially for Azure CLI scripting and Microsoft Graph interactions.
- Clearly indicate which steps require PowerShell and offer alternatives for Linux/macOS users (e.g., using Azure CLI and Microsoft Graph REST API via curl/jq).
- Avoid using Windows-specific tools (e.g., Out-String, ConvertFrom-Json) in cross-platform documentation, or supplement with platform-agnostic alternatives.
- Structure example blocks so that Linux/Bash alternatives are presented alongside or before Windows/PowerShell examples.
- Add a section or callout explaining how Linux users can perform Microsoft Graph operations (e.g., using REST API with curl and jq).
Create Pull Request