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, references .ps1 scripts (Windows PowerShell), and does not provide Linux/macOS shell equivalents or guidance. Script tooling is Windows-centric, and there is no mention of Bash, shell, or cross-platform alternatives. This creates friction for Linux/macOS users who may not use PowerShell or .ps1 scripts.
Recommendations
- Provide CLI examples using Bash/sh syntax alongside PowerShell, especially for az CLI commands.
- Offer Linux/macOS-compatible versions of deployment scripts (e.g., bulk_deployment.sh) and document their usage.
- Clarify whether .ps1 scripts can be run with PowerShell Core on Linux/macOS, or provide native shell alternatives.
- Explicitly state cross-platform compatibility for all commands and scripts.
- List Linux/macOS instructions and examples before or alongside Windows/PowerShell ones, not after.
Create Pull Request