Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in several areas. Script-based image creation instructions for both Bicep and Terraform exclusively use PowerShell (.ps1) scripts and provide only PowerShell command examples, with no equivalent Bash or shell script examples for Linux/macOS users. The prerequisites and instructions repeatedly mention Docker Desktop (a Windows-centric tool) and Azure CLI, but do not clarify Linux alternatives or usage. The documentation refers to PATH variable configuration in a way typical of Windows environments. There are no explicit Linux or macOS script examples, nor any mention of cross-platform script support, leaving Linux users to infer or adapt steps themselves.
Recommendations
- Provide equivalent Bash/shell script examples for Linux/macOS users alongside PowerShell examples.
- Explicitly mention cross-platform compatibility for scripts, or provide separate instructions for Linux/macOS environments.
- Include instructions for installing and using Docker (not just Docker Desktop) on Linux.
- Clarify PATH variable configuration for both Windows and Linux/macOS.
- Where PowerShell is referenced, add a note or link to Linux/macOS alternatives.
- Ensure that all quickstart scripts and automation tools are available in both PowerShell and Bash/shell formats, or document how to use them on non-Windows platforms.
Create Pull Request