Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a Windows bias in several areas. Script-based image creation instructions for both Bicep and Terraform exclusively provide PowerShell (.ps1) examples and commands, with no Bash or Linux/macOS equivalents. The prerequisites and instructions repeatedly mention Docker Desktop (a Windows-centric tool) and Azure CLI, but do not clarify Linux alternatives or usage. There is no mention of how to run the provided scripts on Linux/macOS, nor are cross-platform script variants or guidance provided. This creates friction for Linux/macOS users attempting to follow the quickstart or automation steps.
Recommendations
- Provide Bash (.sh) script equivalents for all PowerShell (.ps1) scripts, with usage instructions for Linux/macOS.
- Include explicit Linux/macOS command-line examples alongside Windows/PowerShell examples.
- Clarify Docker Desktop requirements and provide guidance for Docker Engine on Linux.
- Reorder examples so that cross-platform or Linux-native instructions are presented first or equally.
- Add notes or tabs indicating platform-specific steps, and link to platform-appropriate tooling documentation.
Create Pull Request