Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a strong Windows bias. The core deployment script example is written exclusively in PowerShell, and the only supported script type for deployment scripts is PowerShell. The tutorial and explanations reference PowerShell-specific syntax, escape characters, and troubleshooting steps. While Azure CLI examples are provided for some steps, all scripting and automation focus on PowerShell, with no Bash or Linux shell script equivalents. The documentation does not mention how to author or use deployment scripts with Bash, nor does it provide Linux/macOS-specific guidance for the main scripting workflow.
Recommendations
- Add Bash deployment script examples and clarify if Bash is supported for deployment scripts.
- Provide Linux/macOS-specific troubleshooting steps, especially for script debugging and resource cleanup.
- Explicitly state platform limitations (e.g., if only PowerShell is supported, mention alternatives for Linux users).
- Reorder examples so that CLI/Bash instructions are presented before or alongside PowerShell, not after.
- Include notes or links to cross-platform scripting strategies for ARM template deployment scripts.
Create Pull Request