Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
While the main Azure CLI examples use bash-like syntax compatible with both Windows and Linux, there is a notable Windows bias in the documentation. The only linked template authoring tutorial is 'Quickstart: Create ARM templates with Visual Studio Code', which explicitly references PowerShell tabs and does not mention Linux or bash alternatives. No Linux-specific tools or editors (such as VS Code on Linux, nano, vim, or bash scripting) are mentioned, and the documentation does not clarify cross-platform compatibility for the examples. The documentation assumes familiarity with Windows-first patterns and does not provide parity for Linux users in referenced tutorials.
Recommendations
- Add explicit notes clarifying that Azure CLI examples work on both Windows (PowerShell, CMD) and Linux (bash, zsh).
- Provide links to Linux/bash-specific tutorials for ARM template authoring and deployment.
- Ensure referenced tutorials (such as the Quickstart) include Linux/bash tabs or examples, not just PowerShell.
- Mention cross-platform editors (e.g., VS Code on Linux, nano, vim) when discussing template authoring.
- Where PowerShell is referenced, provide equivalent bash or shell examples and links.
- Review all external links to ensure Linux parity in guidance and examples.
Create Pull Request