Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation page exclusively uses PowerShell commands for all CLI instructions, including installation, project build, configuration, and deployment. There are no Bash, Linux shell, or macOS Terminal equivalents provided, and all deployment steps use PowerShell-specific cmdlets (e.g., Connect-AzAccount, New-AzResourceGroupDeployment), which are not natively available on Linux/macOS. The documentation assumes the user is running PowerShell, creating friction for Linux/macOS users who may use Bash or other shells.
Recommendations
- Provide Bash (Linux/macOS) equivalents for all CLI commands, especially for npm installation and running the CI/CD tool.
- Include Azure CLI commands for deployment steps, as Azure CLI is cross-platform and commonly used on Linux/macOS.
- Explicitly mention platform compatibility for the Stream Analytics CI/CD tool and clarify if PowerShell is required or if Bash/zsh can be used.
- Reorder examples so that cross-platform commands (npm, Azure CLI) appear before or alongside PowerShell examples.
- Add a note or section for Linux/macOS users, outlining any prerequisites or differences in workflow.