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 for interactive examples (such as prompting for secrets/passwords) and references Windows-specific tools like Export-PfxCertificate. Guidance for secure secret entry is only shown in PowerShell, with no Linux shell equivalent. Windows tools and patterns (PowerShell, certificate store) are mentioned before or instead of Linux alternatives, and the Azure CLI section uses different environment variable values for Windows and Linux without clear explanation.
Recommendations
- Provide equivalent secure secret entry examples for Linux shells (e.g., using 'read -s' in bash) alongside PowerShell prompts.
- Mention Linux alternatives to Windows certificate management tools (e.g., 'openssl' for exporting certificates).
- Clarify why environment variable values differ between Windows and Linux for Azure CLI integration, and ensure parity if possible.
- Where PowerShell is used for interactive examples, also show bash/zsh equivalents for Linux/macOS users.
- Avoid referencing Windows certificate store and Export-PfxCertificate without mentioning Linux/macOS certificate handling.
Create Pull Request