Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides only a Windows/Powershell example for Bicep template deployment, using Windows-style paths (e.g., .\ds.bicep) and does not mention or show Linux/macOS CLI equivalents. There is no explicit Linux/macOS example for running the az deployment command, nor any notes about cross-platform usage. The documentation implicitly assumes a Windows environment for command execution, which may cause confusion or friction for Linux/macOS users.
Recommendations
- Provide both Windows and Linux/macOS CLI examples for az deployment group create, using appropriate path separators (e.g., ./ds.bicep for Linux/macOS).
- Add a note clarifying that the Azure CLI works cross-platform and that path syntax differs between Windows (\) and Linux/macOS (/).
- Consider listing Linux/macOS examples first or side-by-side with Windows examples to reinforce parity.
- Explicitly mention that all Bicep templates and Azure CLI commands are platform-agnostic, and provide troubleshooting tips for common Linux/macOS issues (e.g., file permissions, shell differences).
Create Pull Request