Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation is heavily biased towards Windows and PowerShell usage. All code examples and instructions for interacting with Azure Automation webhooks use PowerShell cmdlets and Windows-centric tooling (e.g., Invoke-WebRequest, Az Module), with no mention of Linux/macOS alternatives such as Bash, curl, or cross-platform Azure CLI. REST API examples are also shown only via PowerShell, and there are no Linux shell or Azure CLI examples. This creates friction for Linux/macOS users who may not have PowerShell installed or prefer native tools.
Recommendations
- Add equivalent examples using Bash and curl for webhook creation, invocation, and deletion.
- Include Azure CLI commands for all operations (creating webhooks, invoking them, retrieving job output, etc.), as Azure CLI is cross-platform.
- Show REST API usage with curl or httpie, not just PowerShell's Invoke-RestMethod.
- Explicitly mention platform requirements and provide guidance for Linux/macOS users.
- Reorder examples so that cross-platform methods (REST API, Azure CLI) are presented before or alongside PowerShell examples.
Create Pull Request