Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deployment and cleanup, but PowerShell examples are given equal prominence and are not clearly marked as Windows-only. Visual Studio Code is recommended as the editor, which is cross-platform, but there is no mention of Linux-specific considerations or alternative editors. The documentation does not explicitly mention that PowerShell is primarily a Windows tool, nor does it provide guidance for Linux users regarding shell usage or potential differences. There are no Linux-specific examples or notes about running Azure CLI commands in Bash or other Linux shells.
Recommendations
- Clearly indicate that Azure PowerShell examples are primarily for Windows, and that Azure CLI is cross-platform.
- Provide explicit Bash examples for Azure CLI commands, including variable assignment syntax compatible with Bash (e.g., resourceGroupName="value" instead of resourceGroupName = "value").
- Add notes or tabs for Linux/macOS users, highlighting any differences in command syntax or environment setup.
- Mention alternative editors for Linux users, such as Vim or VS Codium, if relevant.
- Include troubleshooting tips for common Linux issues (e.g., file permissions, path separators) when working with Bicep files.
Create Pull Request