Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in its instructions for uploading certificates to Azure Key Vault. All Azure CLI usage examples are shown in PowerShell syntax, with explicit references to Windows file paths (e.g., C:\Users\Downloads\...), and guidance such as 'configured and installed locally with PowerShell.' There are no Linux/macOS shell examples, nor any mention of how to adapt the commands or file paths for those platforms. This may create friction for non-Windows users attempting to follow the guide.
Recommendations
- Provide Azure CLI examples using Bash syntax alongside PowerShell, including Linux/macOS file path formats (e.g., /home/user/Downloads/isrgrootx1.pem).
- Clarify that Azure CLI works cross-platform and can be used from Bash, zsh, etc., not just PowerShell.
- Remove or rephrase instructions that imply PowerShell is required (e.g., 'configured and installed locally with PowerShell').
- Add notes or sections for Linux/macOS users, highlighting any differences in command usage or environment setup.
Create Pull Request