Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation is heavily PowerShell-centric, requiring PowerShell on all platforms (Windows, Linux, macOS) to use the ARM template test toolkit. All usage examples, including those for pipelines and custom tests, are exclusively in PowerShell. Windows installation instructions are presented first, and there is no mention of alternative Linux-native tools or shell scripting options. Linux and macOS sections simply instruct users to install PowerShell, rather than providing parity with native shell environments.
Recommendations
- Provide examples using native Linux/macOS shells (e.g., Bash, zsh) if possible, or clarify that PowerShell is a hard requirement.
- Explicitly state in the introduction that the toolkit is PowerShell-only and there are no Bash or other shell alternatives.
- Offer guidance for integrating with Linux-native CI/CD tools (e.g., GitHub Actions, Jenkins) using PowerShell, or note limitations.
- Consider developing or linking to cross-platform alternatives or wrappers for users who prefer not to install PowerShell.
- Reorder installation instructions to present all platforms equally, or group by 'PowerShell required' rather than 'Windows first'.
Create Pull Request