Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents deployment instructions using both Azure PowerShell and Azure CLI, but lists PowerShell first and uses Windows-style variable notation ($templateFile) in both examples. There is no explicit mention of Linux/macOS-specific considerations, nor are shell-specific examples (e.g., Bash variable usage) provided. The use of Visual Studio Code as a prerequisite is cross-platform, but the deployment workflow leans toward Windows conventions.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI first to avoid implicit Windows prioritization.
- Include explicit Bash/Linux/macOS examples, such as using environment variables with Bash syntax (e.g., $templateFile or ${templateFile}) and clarifying any differences in command usage.
- Add notes about cross-platform compatibility for both Azure CLI and PowerShell, including installation links for Linux/macOS.
- Clarify that both Azure CLI and PowerShell are available on all major platforms and provide links or instructions for non-Windows users.
- Where variable usage is shown, provide both Windows (PowerShell) and Linux/macOS (Bash) syntax.
Create Pull Request