Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Bash (Azure CLI) and PowerShell examples throughout, ensuring that both Linux/macOS and Windows users are supported. However, PowerShell examples are included for every step, and in some cases, the PowerShell example is more detailed or comes first in the explanation. There is a slight Windows-first bias in the inclusion and prominence of PowerShell, but no critical sections are Windows-only and Linux users can complete all tasks using Bash/Azure CLI.
Recommendations
- Ensure Bash/Azure CLI examples are always presented before PowerShell examples, as Bash is the default shell on Linux/macOS.
- Where possible, avoid giving more detailed or advanced examples in PowerShell than in Bash/Azure CLI.
- Explicitly state that both Bash and PowerShell examples are equivalent and that Bash is recommended for Linux/macOS users.
- Consider adding a short note for macOS users regarding any platform-specific considerations (e.g., Azure CLI installation).
Create Pull Request