Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in its scripting and example sections, especially for Bicep and Terraform workflows. All quickstart and automation scripts are provided as PowerShell (.ps1) files, with example invocations shown only in PowerShell syntax. There are no equivalent Bash or shell script examples for Linux/macOS users, nor are alternative instructions or scripts provided for those platforms. The prerequisites and instructions repeatedly mention Docker Desktop (primarily a Windows/macOS tool) and Azure CLI, but fail to clarify cross-platform usage or offer parity for Linux-native tools and workflows. This bias creates friction for Linux/macOS users who may not have PowerShell installed or prefer Bash/shell scripting.
Recommendations
- Provide equivalent Bash/shell scripts for all PowerShell (.ps1) quickstart scripts, or clarify cross-platform compatibility.
- Include example commands for Linux/macOS users, using Bash syntax and native tools.
- Explicitly mention that Docker Desktop is not required on Linux, where Docker Engine is typically used.
- Reorder examples so that Linux/macOS instructions are presented alongside or before Windows/PowerShell instructions.
- Add notes or tabs for platform-specific instructions, ensuring Linux/macOS users can follow all steps without needing PowerShell.
Create Pull Request