Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides examples for Azure CLI and Azure PowerShell, but the PowerShell examples are detailed and prominent, reflecting a Windows-centric approach. There are no explicit Linux/macOS shell examples (e.g., Bash), and PowerShell is featured as a distinct tab, which may suggest Windows-first bias. The CLI examples use Azure CLI, which is cross-platform, but there are no Linux-specific notes or examples (such as Bash scripting or Linux command-line nuances).
Recommendations
- Add explicit Bash/Linux shell examples for all CLI commands, including environment variable usage and command chaining.
- Clarify that Azure CLI commands work on Linux/macOS and provide any OS-specific caveats (e.g., line continuation differences, authentication methods).
- Balance PowerShell and CLI examples by ensuring Linux/macOS users see their workflows represented equally.
- Consider adding a section or note for Linux/macOS users, highlighting any differences in experience or setup.