Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation demonstrates a significant Windows bias, particularly through its exclusive recommendation and examples of PowerShell scripts for pre- and post-deployment tasks. There is no mention of Bash, shell scripts, or cross-platform alternatives. The guidance assumes the use of PowerShell (including PowerShell Core), and does not provide Linux-native or cross-platform script examples. This may hinder users working in Linux-based CI/CD environments or those preferring non-Windows tooling.
Recommendations
- Provide equivalent Bash or shell script examples for pre- and post-deployment tasks, or clarify how to adapt the PowerShell scripts for Linux environments.
- Explicitly state that PowerShell Core is cross-platform, and provide instructions for installing and running it on Linux and macOS, if PowerShell must be used.
- Mention and, where possible, demonstrate how to use Azure CLI or other cross-platform tools for deployment steps, in addition to or instead of PowerShell.
- Ensure that all script references and downloadable samples include both .ps1 and .sh (or similar) versions, or at least guidance for Linux users.
- Review the documentation for other implicit assumptions of a Windows environment (e.g., file paths, tool availability) and address them for Linux parity.
Create Pull Request