Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Bash and PowerShell examples for most commands, but PowerShell is given equal or greater prominence throughout, including custom PowerShell cmdlets for Azure operations. There are several places where Windows-specific tools (PowerShell, Docker Desktop for Windows) are mentioned, and PowerShell examples are often more detailed or complex than Bash. The documentation does not provide Linux shell alternatives for PowerShell-specific Azure cmdlets, and Docker Desktop is referenced as the default for local builds, which is more common on Windows/macOS than Linux. There is no explicit mention of Linux-native tools or patterns (e.g., Podman, native Docker engine on Linux, or Linux-specific troubleshooting).
Recommendations
- For every PowerShell example, ensure there is a Bash (or POSIX shell) equivalent, especially for Azure operations that use custom PowerShell cmdlets (e.g., New-AzContainerApp).
- Mention and provide instructions for using native Docker engine on Linux, not just Docker Desktop.
- Where PowerShell-specific Azure cmdlets are used, note that these are Windows-centric and provide Azure CLI alternatives for Linux users.
- Avoid assuming Docker Desktop is the default on Linux; clarify that Linux users can install Docker engine directly.
- Add troubleshooting and environment setup notes for Linux users (e.g., permissions, systemd, networking).
- Consider including a Linux-first section or callout to ensure parity and visibility for Linux workflows.
Create Pull Request