Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides parallel instructions for Azure CLI, Azure PowerShell, and Azure Developer CLI, but the inclusion of Azure PowerShell is a Windows-centric choice. There are no explicit Linux/macOS shell examples (e.g., Bash), and PowerShell is presented as an equal alternative to Azure CLI, despite its limited adoption on Linux/macOS. The document does not mention platform-specific differences or provide guidance for Linux/macOS users, and PowerShell examples may confuse or alienate non-Windows users.
Recommendations
- Add explicit Bash or shell examples for Linux/macOS users, especially where PowerShell is shown.
- Clarify that Azure CLI commands work cross-platform and are recommended for Linux/macOS.
- Note that PowerShell is primarily for Windows, and provide installation or usage notes for Linux/macOS if PowerShell is to be used.
- Consider reordering examples to show Azure CLI (cross-platform) first, and PowerShell second.
- Where text editors are mentioned, suggest cross-platform editors (e.g., nano, vim, VS Code) rather than assuming Notepad or Windows tools.
Create Pull Request