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 workflows for building and pushing custom container images are presented exclusively using PowerShell (.ps1) scripts, with invocation examples shown only for Windows/PowerShell environments. There is no mention of equivalent Bash or shell scripts for Linux/macOS users, nor are cross-platform alternatives provided. The prerequisites and instructions reference Docker Desktop (primarily a Windows/Mac tool) and Azure CLI, but do not clarify Linux compatibility or provide Linux-specific guidance. The order of presentation and examples implicitly prioritize Windows tooling and patterns, 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 Linux/macOS compatibility for all scripts and tools, and clarify any platform-specific requirements.
- Offer cross-platform instructions for installing prerequisites (e.g., Docker, Azure CLI) on Linux, not just Docker Desktop.
- Where scripts are referenced, indicate if both .ps1 and .sh versions are available, or provide guidance for adapting PowerShell scripts to Bash.
- Ensure that example commands (e.g., for building/pushing images) are shown for both Windows (PowerShell) and Linux/macOS (Bash/CLI) environments.
- Avoid using Windows-specific terminology (e.g., PATH variables, PowerShell invocation) without also referencing Linux equivalents.
Create Pull Request