Document Details
Test Toolkit
❌
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
Summary:
The documentation is heavily PowerShell-centric, reflecting the fact that the ARM template test toolkit is implemented as a set of PowerShell scripts. All usage examples, including those for Linux and macOS, require PowerShell (pwsh) and do not provide alternatives using native Linux/Unix shell tools or scripting languages. The Windows installation instructions are presented before Linux and macOS, and the overall workflow assumes familiarity with PowerShell commands and concepts (e.g., execution policy, Import-Module). There is no mention of using the toolkit outside PowerShell, nor are there any Bash, Python, or other cross-platform scripting examples.
Recommendations:
- Clearly state at the beginning that the toolkit is PowerShell-based and required on all platforms.
- Consider providing or linking to wrapper scripts or Docker containers that allow running the toolkit without requiring users to install PowerShell, especially for Linux users.
- If possible, develop and document alternative usage patterns or tools for Linux users who may not be familiar with PowerShell (e.g., Bash scripts that invoke PowerShell, or a CLI wrapper).
- Present Linux and macOS instructions before or alongside Windows instructions to avoid the impression of Windows primacy.
- Explicitly acknowledge the PowerShell dependency as a limitation for some Linux environments and suggest workarounds or community solutions.
- Where possible, provide example commands in both Windows and Linux/macOS path formats and shell conventions.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-08-24 00:00 | #90 | in_progress | ❌ Biased |
| 2025-07-24 00:00 | #59 | completed | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |