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. Windows installation instructions are presented first, and all usage examples (including CI/CD pipeline integration) rely exclusively on PowerShell commands and modules. There is no mention of native Linux shell alternatives, nor are there Bash or other Linux-native scripting examples. The toolkit itself is described as a set of PowerShell scripts, which inherently favors Windows environments and workflows.
Recommendations
- Provide Bash or shell script examples for Linux users, where possible, or clarify if PowerShell is the only supported method.
- Explicitly state that the toolkit is PowerShell-only and discuss any limitations or alternatives for users who prefer native Linux tools.
- Consider developing or recommending cross-platform wrappers or CLI tools that do not require PowerShell, to improve accessibility for Linux users.
- Reorder installation instructions to present Linux and macOS before Windows, or present all platforms in parallel to avoid Windows-first bias.
- Add troubleshooting and environment setup guidance specific to Linux (e.g., common issues with PowerShell on Linux, permissions, dependencies).
Create Pull Request