Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides both Bash and PowerShell examples for all major steps, maintaining some parity. However, PowerShell (a Windows-centric tool) is given equal prominence throughout, and Windows-specific PowerShell modules and patterns (such as Install-Module, New-AzKeyVault, etc.) are described in detail. There is no mention of Linux-native alternatives to PowerShell, nor is there any discussion of using Linux-specific tools or patterns (e.g., shell scripting, environment variable management, or secret management outside Azure CLI). The documentation assumes PowerShell is a primary cross-platform shell, which is a Windows-centric perspective.
Recommendations
- Clarify that PowerShell is available cross-platform, but Bash is the default shell on most Linux systems.
- Provide guidance or links for users who may be using other Linux shells (e.g., zsh, fish) or native Linux tools.
- Consider including notes or examples for Linux-native secret management (e.g., using environment variables, .env files) where appropriate.
- Explicitly state that PowerShell examples are for users who prefer it, but Bash is more common on Linux.
- Ensure that Bash examples are listed first, as Bash is the default on Linux, to avoid implicit Windows-first bias.
- Add troubleshooting tips for common Linux-specific issues (e.g., permissions, environment variable persistence).
Create Pull Request