Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page exhibits a notable Windows bias in its scripting and tooling instructions. The only explicit examples for running the provided quickstart scripts are given in PowerShell, with no equivalent Bash or Linux/macOS shell commands. The instructions repeatedly require 'Docker Desktop', which is a Windows/macOS-specific tool, rather than referencing the more cross-platform Docker Engine. There are no Linux/macOS-specific instructions or examples for building and pushing images, and the PowerShell examples are presented first and exclusively. This creates friction for Linux users, who must adapt the instructions themselves.
Recommendations
- Provide equivalent Bash (sh) script examples for Linux/macOS users alongside PowerShell commands.
- Clarify whether the quickstart scripts are cross-platform (e.g., provide .sh scripts if available, or note their absence).
- Reference Docker Engine (the cross-platform CLI) rather than 'Docker Desktop' where possible, or clarify that Docker Desktop is only required on Windows/macOS.
- Explicitly mention prerequisites and installation steps for Linux/macOS users (e.g., installing Azure CLI and Docker on Ubuntu).
- Order examples so that cross-platform or Linux instructions are presented alongside or before Windows-specific ones.
- If only PowerShell scripts are available, provide guidance for Linux users on how to adapt or run them (e.g., via PowerShell Core on Linux, or alternative manual steps).
Create Pull Request