Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a notable Windows bias in the 'Customer Managed Key' section, where several steps use PowerShell syntax and Windows-specific tooling (e.g., Connect-Graph, New-MgServicePrincipal, Out-String, ConvertFrom-Json). These commands are not cross-platform and lack equivalent Bash/Linux examples, creating friction for Linux/macOS users. The rest of the guide is mostly Azure CLI-based and cross-platform, but the critical steps for customer-managed keys are Windows-centric.
Recommendations
- Provide Bash/Linux equivalents for all PowerShell commands, especially for Azure AD and Microsoft Graph interactions.
- Explicitly note which commands require Windows/PowerShell and offer alternatives for Linux/macOS users.
- Where possible, use Azure CLI or REST API calls instead of PowerShell modules.
- Add a dedicated section or callouts for Linux/macOS users to clarify how to perform each step without PowerShell.
- Ensure all example scripts and variable manipulations are shown in both Bash and PowerShell where applicable.
Create Pull Request