Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
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, customization, and pipeline integration instructions are provided only in PowerShell, with no alternatives using native Linux tools or shells (e.g., Bash). The Windows installation instructions are presented before Linux and macOS, and Windows-specific concepts like execution policy are referenced throughout. There is no mention of using the toolkit with other scripting environments or providing Bash-native examples.
Recommendations
- Provide Bash or shell script examples for Linux and macOS users, where possible.
- Clarify if the toolkit can be used with other scripting environments (e.g., Python, Bash) or if PowerShell is strictly required.
- Offer instructions for running the toolkit via Docker or containerized environments to simplify cross-platform usage.
- Add Linux-first or platform-neutral sections, and avoid always listing Windows instructions first.
- Reference Linux-native tools and patterns (e.g., unzip, tar) for extracting files, rather than only PowerShell commands.
- Discuss any limitations or differences in PowerShell usage on Linux/macOS versus Windows.
Create Pull Request