Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Azure CLI and PowerShell examples for all operations, but PowerShell is featured as a primary automation option throughout, and is listed as a prerequisite alongside Azure CLI. PowerShell is a Windows-centric tool, and its prominence may suggest a Windows bias. Visual Studio Code is recommended as the editor, which is cross-platform, but no mention is made of Linux-native editors or shell environments. There are no Linux-specific instructions, troubleshooting, or notes about platform differences. The documentation does not provide explicit Linux shell examples (e.g., bash scripts), nor does it mention WSL or Linux package managers for installation.
Recommendations
- Add explicit notes clarifying that Azure CLI commands work natively on Linux/macOS and Windows, and provide any necessary platform-specific instructions (e.g., file path syntax, line continuation differences).
- Include bash shell script examples or highlight usage in Linux terminal environments where appropriate.
- Mention Linux-native editors (e.g., Vim, Nano) as alternatives to Visual Studio Code, or clarify VS Code's cross-platform support.
- Provide installation instructions for Azure CLI and Bicep on Linux (e.g., apt, yum, snap) in the prerequisites section.
- If PowerShell is included, clarify that PowerShell Core is cross-platform, and provide installation instructions for Linux/macOS.
- Add troubleshooting notes for common Linux-specific issues (e.g., permissions, environment variables).
Create Pull Request