Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits a notable Windows bias: all deployment script examples use PowerShell, and the ARM template's deploymentScripts resource only demonstrates the 'AzurePowerShell' kind. There is no example or mention of Bash or Linux shell scripting for deployment scripts, nor are Linux/macOS equivalents for PowerShell commands provided. PowerShell-specific patterns (such as escape characters and cmdlets) are explained in detail, while Linux alternatives are absent or secondary. The CLI examples are present for some steps, but the core scripting and troubleshooting are PowerShell-centric.
Recommendations
- Add equivalent Bash (Azure CLI) deployment script examples, showing how to create and add certificates using Bash.
- Document the 'AzureCLI' kind for deploymentScripts, including sample scriptContent in Bash.
- Clarify platform support for deploymentScripts (e.g., which features are Windows-only, which work cross-platform).
- Provide troubleshooting steps for Linux/macOS users, including how to access and interpret output files.
- Ensure all critical steps have both PowerShell and Bash/CLI examples, and alternate which is presented first.
Create Pull Request