Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation consistently uses PowerShell syntax and Windows-specific tools (e.g., Connect-AzAccount, New-AzResourceGroupDeployment) for all command-line examples, with no mention or examples for Linux/macOS shells (bash, sh, etc.) or Azure CLI equivalents. The only explicit OS note is that JavaScript UDFs only work on Windows, but otherwise, Linux users are left to infer compatibility and usage. This creates friction for non-Windows users attempting to follow the guide.
Recommendations
- Provide bash/sh examples alongside PowerShell for all CLI commands, especially npm and azure-streamanalytics-cicd usage.
- Include Azure CLI equivalents for deployment steps, not just Azure PowerShell.
- Explicitly state OS compatibility for the npm package and commands.
- Add notes or troubleshooting for common Linux/macOS issues (e.g., path separators, permissions).
- Reorder examples so that cross-platform or Linux/macOS instructions are shown first or equally.
Create Pull Request