Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation consistently uses PowerShell syntax for CLI commands and references PowerShell scripts (.ps1) as the primary automation method, with no mention of Bash, shell scripts, or Linux/macOS-specific instructions. All code blocks are labeled as 'powershell', and there is no guidance for running commands in Linux/macOS terminals. The bulk deployment automation is provided only as a PowerShell script, and workflow deletion is also Windows-centric. This creates friction for Linux/macOS users who may not have access to PowerShell or prefer native shell environments.
Recommendations
- Provide CLI command examples using Bash syntax and clarify cross-platform usage (e.g., az CLI works on Linux/macOS).
- Offer equivalent Bash or shell scripts for bulk deployment and workflow deletion, or document how to use PowerShell Core on Linux/macOS.
- Explicitly state platform requirements for provided scripts and tools, and link to cross-platform installation guides if PowerShell is required.
- Reorder examples so that cross-platform CLI usage is shown before or alongside PowerShell-specific instructions.
- Add notes or tabs indicating how Linux/macOS users can perform the same tasks, including any required environment setup.
Create Pull Request