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, as the ARM template test toolkit is implemented as a set of PowerShell scripts. All usage examples, regardless of platform (Windows, Linux, macOS), require PowerShell and provide only PowerShell commands. The Windows installation section is presented first, and there are no examples using native Linux tools or shell scripting. The toolkit itself is fundamentally tied to Windows/PowerShell paradigms, and Linux instructions are essentially adaptations for running PowerShell Core on Linux, rather than offering a native Linux experience.
Recommendations:
  • Clearly state at the beginning that the toolkit is PowerShell-based and requires PowerShell on all platforms.
  • Consider providing or linking to a cross-platform wrapper or alternative (e.g., a Docker image or a CLI tool) for users who prefer not to use PowerShell.
  • Offer bash or shell script examples for common tasks, even if they simply invoke PowerShell scripts, to better align with Linux user expectations.
  • If possible, develop and document a native Linux/Unix CLI interface or provide guidance for integrating the toolkit into typical Linux CI/CD workflows.
  • In the installation sections, present Linux and macOS instructions before or alongside Windows, or group them together to avoid a Windows-first impression.
GitHub 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

Flagged Code Snippets

Get-ChildItem *.ps1, *.psd1, *.ps1xml, *.psm1 -Recurse | Unblock-File
Import-Module .\arm-ttk.psd1