Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation consistently provides both Bash (Azure CLI) and PowerShell examples for all commands, with PowerShell examples using Windows-centric cmdlets (e.g., Get-AzContainerAppRevision, Update-AzContainerApp). In several cases, PowerShell examples are given even when no direct PowerShell equivalent exists, and the Bash/Azure CLI examples are sometimes presented as secondary or fallback. The use of PowerShell cmdlets and parameters reflects a bias toward Windows tooling and patterns, and the documentation assumes familiarity with Windows/PowerShell environments.
Recommendations
- Clearly indicate that PowerShell examples are for Windows users and Bash examples are for Linux/macOS users, to avoid confusion.
- Ensure Bash/Azure CLI examples are presented first, as Azure CLI is cross-platform and more widely used in Linux environments.
- Where PowerShell examples use Azure CLI commands (e.g., az containerapp revision copy), clarify that these can be run in any shell, not just PowerShell.
- Add explicit notes or sections for Linux/macOS users, including troubleshooting tips or environment setup instructions.
- Avoid using Windows-specific cmdlets or patterns unless there is no cross-platform alternative, and always provide a CLI-based example.
- Consider adding examples for other shells (e.g., zsh, fish) or scripting environments where relevant.
Create Pull Request