Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all operations, but PowerShell is featured equally alongside CLI, and is referenced in the prerequisites and throughout. PowerShell is a Windows-centric tool, and its inclusion may suggest a Windows bias, especially for users on Linux or macOS. Visual Studio Code is recommended as the editor, which is cross-platform, but no mention is made of alternative editors or shell environments. There are no explicit Linux shell examples (e.g., bash), nor are there notes about platform-specific differences or recommendations for Linux users.
Recommendations
- Clarify that Azure CLI commands work natively on Linux, macOS, and Windows, and highlight this in the prerequisites.
- Add explicit bash/zsh shell examples for Linux/macOS users, especially for command-line operations (e.g., using export for environment variables, using forward slashes, etc.).
- Mention that PowerShell Core is available cross-platform, but note that Azure CLI is often preferred on Linux/macOS.
- Include notes about installing Azure CLI and Bicep on Linux/macOS, with links to platform-specific instructions.
- Suggest alternative editors (e.g., Vim, Sublime Text) for users who do not use Visual Studio Code.
- Consider reordering examples to show Azure CLI (Linux/macOS friendly) first, or clarify that both CLI and PowerShell are supported equally across platforms.
Create Pull Request