Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation repeatedly instructs users to download and run a PowerShell script for ARM template sanitization, specifying usage in Windows PowerShell, PowerShell Core, or Visual Studio Code. There are no equivalent instructions or examples for Linux/macOS users, nor are alternative methods (such as Azure CLI, Bash, or cross-platform scripting) mentioned. The only script execution guidance provided is for PowerShell, and the prerequisite command (Set-ExecutionPolicy) is Windows-specific. This creates friction for users on Linux or macOS, who may not have PowerShell installed or may prefer native tools.
Recommendations
- Provide explicit instructions for running the PowerShell script on Linux/macOS using PowerShell Core (pwsh), including installation steps if needed.
- Offer alternative methods for ARM template sanitization, such as using Azure CLI, Bash scripts, or manual steps that do not require PowerShell.
- Include cross-platform notes and examples, ensuring Linux/macOS users are not excluded from critical steps.
- Reorder or parallelize instructions so that Windows and Linux/macOS approaches are presented together, rather than Windows-first.
Create Pull Request