Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a mild Windows bias. PowerShell examples and references are presented alongside Azure CLI, but Windows-specific tools (like Git Bash for Windows) are mentioned before native Linux options. The prerequisites and examples often reference Windows-first patterns, such as recommending Git Bash (a Windows solution) for Bash shells and listing Azure PowerShell as a primary option. There is no explicit mention of Linux-native shells or tools, and the CLI instructions do not clarify that they work natively on Linux/macOS. The documentation does not provide Linux-specific troubleshooting or environment setup guidance.
Recommendations
- Explicitly mention that Azure CLI commands work natively on Linux and macOS terminals, not just in Git Bash for Windows.
- In prerequisites, recommend standard Bash shells available on Linux/macOS (e.g., GNOME Terminal, macOS Terminal) before or alongside Git Bash for Windows.
- Add notes or sections for Linux/macOS users, including package installation commands for Azure CLI and Bicep on those platforms.
- Ensure parity in troubleshooting and environment setup instructions for Linux/macOS users.
- Consider providing examples of using Azure CLI in Linux/macOS environments, and clarify that PowerShell is optional for those platforms.
Create Pull Request