Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page provides all command-line examples and scripts in PowerShell syntax, including a complex function for cluster creation. No Bash or Linux/macOS shell equivalents are given, and PowerShell is used for Azure CLI invocation throughout. This creates friction for Linux/macOS users, who typically use Bash and may not be familiar with PowerShell scripting.
Recommendations
- Provide Bash shell equivalents for all PowerShell scripts and command examples.
- Explicitly note that Azure CLI commands work cross-platform and show usage in Bash (e.g., with environment variables, parameter passing).
- Avoid wrapping Azure CLI commands in PowerShell functions unless a Bash alternative is also provided.
- Clarify any platform-specific requirements or differences in the prerequisites section.
Create Pull Request