Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page shows moderate Windows bias in the advanced (customer-managed key) scenario. Several steps use PowerShell syntax and Windows-specific tools (e.g., Microsoft Graph PowerShell SDK) without providing equivalent Bash or cross-platform alternatives. PowerShell commands are interleaved with Azure CLI, and variables are set using PowerShell syntax, which may not work for Linux/macOS users. The initial sections are cross-platform, but the advanced scenario assumes a Windows/PowerShell environment. Linux parity is restored in the attestation section, which is Linux-focused.
Recommendations
- For every PowerShell command, provide a Bash (or cross-platform) equivalent, especially for variable assignment and Azure CLI invocations.
- Clearly separate Windows/PowerShell and Linux/Bash instructions, or provide tabs for both environments.
- For steps requiring Microsoft Graph, provide REST API or Azure CLI alternatives, or link to platform-agnostic instructions.
- Avoid using PowerShell-specific constructs (e.g., Out-String, ConvertFrom-Json, $var assignment) in mainline CLI documentation unless alternatives are shown.
- Review the order of examples to ensure neither Windows nor Linux is prioritized without justification.
- Add a note at the start of advanced sections clarifying which OS/shell the instructions target, and link to equivalents for other platforms.
Create Pull Request