Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Linux and Windows examples for environment variable setup, but consistently uses PowerShell syntax for interactive prompts and sensitive variable entry (e.g., Read-Host), even in sections not explicitly marked as Windows-specific. Guidance for exporting certificates references Windows tools (Export-PfxCertificate) without Linux alternatives. In the Azure CLI section, the Windows example uses PSCRED (PowerShell credential) rather than AZCLI, which may confuse users. PowerShell examples and terminology are often presented first or exclusively for sensitive operations, creating friction for Linux/macOS users.
Recommendations
- Provide equivalent Linux/macOS shell examples for interactive variable entry (e.g., using 'read -s' in Bash for secrets) wherever PowerShell/Read-Host is shown.
- Reference Linux/macOS certificate export tools (e.g., openssl) alongside Windows Export-PfxCertificate.
- Clarify the correct environment variable values for AZCOPY_AUTO_LOGIN_TYPE for both platforms (e.g., AZCLI for Azure CLI on all OSes, PSCRED for PowerShell only).
- Ensure that sensitive operations (like setting secrets) have cross-platform guidance and do not default to PowerShell-only examples.
- Where possible, present Linux/macOS and Windows examples side-by-side, or alternate which is shown first.
Create Pull Request