Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits a strong Windows bias. PowerShell is the only scripting language used for deployment scripts, with no mention of Bash or other Linux-native scripting options. The deployment script example is exclusively written in PowerShell, and references to PowerShell quoting rules and escape characters are provided, while Linux shell equivalents are omitted. The tutorial's workflow and troubleshooting steps focus on PowerShell and Windows-centric tools, with CLI examples present but secondary. There is no guidance for authoring deployment scripts in Bash or for Linux users who may prefer non-PowerShell approaches.
Recommendations
- Add Bash examples for deployment scripts, especially for tasks like certificate creation and key vault management.
- Document how to use 'AzureCLI' as the 'kind' property in deploymentScripts, and provide sample Bash scripts.
- Include troubleshooting steps for Bash-based deployment scripts, such as where to find output and error logs.
- Reference Linux shell quoting and escape rules alongside PowerShell equivalents.
- Ensure CLI and Bash examples are given equal prominence to PowerShell, and avoid presenting Windows tools first.
- Clarify platform requirements and limitations (e.g., if only PowerShell is supported, state this explicitly and provide roadmap for Bash support if planned).
Create Pull Request