Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation consistently uses PowerShell syntax for all CLI examples, including npm installation, project build, local run, test case addition, unit testing, and Azure deployment. No Linux/macOS shell (bash/sh/zsh) equivalents are provided. Azure PowerShell modules and commands are used exclusively for deployment, with no mention of Azure CLI or cross-platform alternatives. The only explicit OS-specific note is that JavaScript UDFs work only on Windows, but otherwise, the documentation assumes a Windows/PowerShell environment throughout.
Recommendations
- Provide bash/sh/zsh examples alongside PowerShell for all CLI commands, especially for npm install and azure-streamanalytics-cicd usage.
- Include Azure CLI deployment instructions (az deployment group create) as an alternative to PowerShell for ARM template deployment.
- Clarify cross-platform compatibility of the npm package and commands, noting any Windows-only features (e.g., JavaScript UDFs).
- Explicitly state OS requirements and limitations at the top of the documentation.
- Reorder examples or provide tabs for Windows (PowerShell) and Linux/macOS (bash) usage to improve parity.
Create Pull Request