Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a strong Windows/PowerShell bias. All deployment script examples use PowerShell exclusively, and the only supported script kind is 'AzurePowerShell'. The tutorial and explanations focus on PowerShell syntax, quoting rules, and error messages. While Azure CLI examples are provided for template deployment, there are no examples or guidance for authoring or running deployment scripts using Bash or other Linux-native tools. The documentation does not mention or demonstrate Linux scripting patterns, and PowerShell is presented as the default and only option for deployment scripts.
Recommendations
- Add Bash-based deployment script examples and guidance, especially for the 'Microsoft.Resources/deploymentScripts' resource, to demonstrate Linux parity.
- Explicitly mention and demonstrate how to use 'AzureCLI' as the 'kind' for deployment scripts, including sample Bash scripts for the same scenario.
- Balance the order of examples and explanations so that Linux/Bash/CLI options are presented alongside or before Windows/PowerShell options.
- Include troubleshooting and debugging steps for Bash-based deployment scripts, not just PowerShell.
- Clarify in the documentation which features are PowerShell-only and which are available for Bash/CLI, and update the tutorial to cover both platforms where possible.
Create Pull Request