Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation consistently presents Windows-centric tools (PowerShell) alongside Azure CLI, with PowerShell examples and terminology appearing as a primary focus. There are no explicit Linux/macOS shell examples (e.g., Bash), and installation instructions for Azure CLI do not mention platform-specific details for Linux/macOS. The use of Visual Studio Code is mentioned, but no alternative editors or platform-specific guidance is provided. The CLI examples use Azure CLI, which is cross-platform, but PowerShell examples are given equal or greater prominence, and sometimes appear first. There is no mention of Linux-specific patterns, troubleshooting, or environment setup.
Recommendations
- Add explicit Bash shell examples for all Azure CLI commands, demonstrating usage on Linux/macOS.
- Provide installation instructions for Azure CLI and PowerShell that include Linux/macOS steps and links.
- Clarify that Azure CLI is cross-platform and highlight any platform-specific considerations (e.g., file paths, permissions).
- Mention alternative editors for Bicep files (e.g., Vim, nano) for Linux/macOS users.
- Ensure that CLI examples are shown before or alongside PowerShell, not after.
- Add troubleshooting notes for common Linux/macOS issues (e.g., permissions, environment variables).
Create Pull Request