Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides a single example of template execution using PowerShell syntax (with Windows-style paths and backslashes), and does not offer a Linux/macOS equivalent (e.g., Bash or CLI with forward slashes). The only command-line example is Windows-centric, which may cause friction for Linux/macOS users. The Bicep templates themselves are cross-platform, but the operational instructions favor Windows.
Recommendations
- Include equivalent Azure CLI example using Bash syntax (forward slashes, suitable for Linux/macOS terminals).
- Add a note clarifying that the az CLI works on all platforms and provide platform-specific command examples.
- Show both Windows and Linux/macOS command-line examples side-by-side for template deployment.
- Avoid using only backslashes in file paths; show both .\ds.bicep (Windows) and ./ds.bicep (Linux/macOS).
Create Pull Request