Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Linux/macOS and Windows examples for ORAS commands, but Windows examples are consistently presented after Linux/macOS, and use Windows-specific syntax (cmd.exe, .\oras.exe, caret line continuation). There is a notable emphasis on Docker Desktop credential store, which is primarily a Windows/Mac tool, and no mention of Linux-native credential management. The authentication section references Microsoft Entra and Azure CLI, which are cross-platform, but the Docker credential store reference is Windows-centric. There are no missing Linux examples, but Windows-specific tools and patterns are mentioned.
Recommendations
- Present Linux and Windows examples in parallel, or alternate which is shown first to avoid implicit prioritization.
- Explicitly mention Linux-native credential management options (e.g., Docker credential helpers for Linux, or ORAS config file usage).
- Clarify that Docker Desktop credential store is available on Windows and Mac, and provide equivalent instructions for Linux users (e.g., using docker-credential-pass or other Linux credential helpers).
- Where possible, use platform-agnostic commands, or provide clear guidance for each platform, including Linux-specific nuances.
- Review references to Windows tools (e.g., .\oras.exe) and ensure Linux equivalents are equally described and visible.
Create Pull Request