Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page demonstrates a moderate Windows bias. Several critical steps in the customer-managed key workflow rely on PowerShell commands and Windows-centric tooling (e.g., Microsoft Graph SDK for PowerShell, use of PowerShell syntax for variable assignment and piping). These examples are given without equivalent Bash/Linux alternatives, and PowerShell is introduced before any Linux scripting options. Additionally, instructions for attestation sample apps mention Windows as a secondary option, with Linux as the primary example, but do not provide Windows build instructions inline.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell commands, especially for Azure AD and Key Vault operations.
- Include instructions for installing and using Microsoft Graph SDK on Linux, or suggest cross-platform alternatives.
- Ensure variable assignment and command chaining examples use Bash syntax where appropriate, or offer both PowerShell and Bash versions side-by-side.
- Add inline build instructions for the attestation sample app on Windows, not just a link.
- Review the order of examples and tooling references to avoid introducing Windows-specific tools before Linux equivalents.
- Explicitly state cross-platform compatibility for all CLI commands and scripts, and clarify any OS-specific requirements.
Create Pull Request