Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Bash and PowerShell examples throughout, but PowerShell coverage is extensive and often includes Windows-specific cmdlets (e.g., New-AzContainerRegistry, Remove-AzResourceGroup) that are only available on Windows or require Windows PowerShell. In some sections, PowerShell instructions are more detailed than Bash, and Windows tools (Docker Desktop for Windows, PowerShell cmdlets) are mentioned explicitly. Bash examples are present, but PowerShell is given equal or greater prominence, which may create friction for Linux/macOS users.
Recommendations
- Ensure Bash examples are always shown first, as Bash is the default shell on Linux/macOS.
- Clarify that PowerShell cmdlets require Windows or PowerShell Core, and provide Bash/Azure CLI equivalents wherever possible.
- For Docker installation, mention Linux-native Docker installation methods before Docker Desktop for Windows.
- Where PowerShell instructions are more detailed, ensure Bash/Azure CLI instructions are equally comprehensive.
- Add explicit notes when a command or tool is Windows-only, and suggest Linux/macOS alternatives.
Create Pull Request