Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Bash (Azure CLI) and PowerShell examples for all major revision management tasks in Azure Container Apps. However, PowerShell examples are given equal prominence and detail as Bash, and in some cases, PowerShell-specific cmdlets are used. This can indicate a bias toward Windows users, as PowerShell is primarily a Windows-centric tool (despite cross-platform support), and its inclusion may suggest a Windows-first mindset. Bash examples are present and complete, so Linux/macOS users are not blocked, but the parity in example coverage may create friction for non-Windows users.
Recommendations
- Clearly state that Bash examples are suitable for Linux/macOS and that PowerShell examples are for Windows or cross-platform PowerShell users.
- Consider listing Bash examples first to reflect the cross-platform default for Azure CLI.
- Add notes clarifying when PowerShell cmdlets are Windows-only or require Azure PowerShell module, and when Azure CLI commands are preferred for Linux/macOS.
- If possible, provide examples using only Azure CLI (which is fully cross-platform) and minimize PowerShell-specific cmdlets unless necessary.
- Ensure that any advanced scenarios or troubleshooting steps are covered with Bash/Azure CLI examples, not just PowerShell.
Create Pull Request