Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Bash and PowerShell examples for all CLI commands, ensuring parity for Linux/macOS and Windows users. However, PowerShell examples are always shown alongside Bash, and in some cases, Windows-specific advice (e.g., using Mono or Windows containers for .NET Framework builds) is given before Linux alternatives. The troubleshooting section suggests Windows containers as a solution for .NET Framework, which may reinforce a Windows-centric mindset. There are no sections that are Windows-only, and Linux users can complete all tasks using Bash and Azure CLI.
Recommendations
- Consider listing Bash examples before PowerShell throughout the documentation to reflect the default shell on Linux/macOS and most CI/CD environments.
- When suggesting solutions for .NET Framework builds, present Linux/Mono options before Windows containers, and clarify the trade-offs.
- Explicitly mention that all Azure CLI commands work on Linux/macOS and Windows, and provide links to platform-specific installation guides if needed.
- Where troubleshooting suggests Windows containers, provide equal detail for Linux/Mono solutions and clarify when Windows containers are strictly required.
- Add a short note at the beginning confirming full support for Linux/macOS workflows.
Create Pull Request