Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page exclusively uses PowerShell syntax for all command-line examples, including the main deployment script and resource cleanup. There are no Bash or Linux/macOS shell examples, and the scripting patterns (e.g., function definition, parameter passing) are tailored for PowerShell, which is native to Windows. This creates friction for Linux/macOS users, who typically use Bash or other shells and may not be familiar with PowerShell scripting.
Recommendations
- Provide equivalent Bash shell examples for all command-line instructions, especially for the main cluster creation workflow.
- Include notes clarifying that Azure CLI commands work cross-platform, and show usage in both Windows (PowerShell) and Linux/macOS (Bash).
- Avoid using PowerShell-specific scripting constructs (e.g., function definitions, parameter blocks) unless also providing a Bash alternative.
- Explicitly mention platform compatibility and link to Azure CLI installation guides for Linux/macOS.
Create Pull Request