Document Details
Sentinel Playbook Creation
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
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation demonstrates a notable Windows bias in the playbook ARM template generation steps. It exclusively references a PowerShell script for sanitizing ARM templates, instructs users to use Windows PowerShell, PowerShell Core, or Visual Studio Code, and provides only Windows-centric instructions (including Set-ExecutionPolicy). There are no equivalent instructions or examples for Linux/macOS users, such as using Azure CLI, Bash, or cross-platform scripting alternatives. This may create friction for non-Windows users attempting to follow the guide.
Recommendations
- Provide Linux/macOS instructions for running the PowerShell script, including prerequisites (e.g., installing PowerShell Core on Linux/macOS).
- Offer alternative methods for ARM template sanitization, such as using Azure CLI, Bash scripts, or cross-platform tools.
- Explicitly mention how to run the script on Linux/macOS, including any required changes (e.g., file permissions, execution policy).
- Include examples or screenshots from Linux/macOS environments where applicable.
- List any dependencies or limitations for non-Windows platforms up front.
Create Pull Request
Clean