Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation generally presents Azure CLI and Azure PowerShell as the primary command-line tools for interacting with Bicep and Azure resources. In several places, PowerShell is mentioned alongside or before CLI, and examples are always given for both, but there is no mention of Bash, Linux-specific shells, or Linux-native tools. The use of Visual Studio Code (cross-platform) is appropriate, but the command-line examples and tool recommendations are Windows-centric, with no explicit Linux or macOS guidance or examples. The documentation does not provide parity for Linux users in terms of shell commands, package management, or troubleshooting.
Recommendations
- Explicitly mention that Azure CLI is cross-platform and can be used on Linux, macOS, and Windows.
- Provide Bash or shell examples where command-line usage is shown, especially for common tasks (e.g., using az in Bash).
- When referencing PowerShell, clarify that PowerShell Core is available on Linux and macOS, or provide Bash equivalents.
- Include Linux/macOS-specific troubleshooting tips or installation notes, such as using apt, yum, or Homebrew for installing tools.
- Ensure that any references to file paths, keyboard shortcuts, or context menus clarify platform differences (e.g., Ctrl vs Cmd, path separators).
- Add a section or callout for Linux/macOS users to ensure parity in setup and usage.
Create Pull Request