Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a strong Windows bias. All code examples and walkthroughs use PowerShell cmdlets and scripting, which are native to Windows and not available by default on most Linux distributions. The instructions for creating, using, and managing webhooks rely exclusively on PowerShell tools (Az Module, Invoke-WebRequest, etc.), and there are no equivalent examples for Linux shell environments (e.g., Bash, curl, Azure CLI). REST API usage is also shown only via PowerShell's Invoke-RestMethod, not with cross-platform tools. The page does not provide Linux or macOS-specific guidance, nor does it mention or demonstrate using Azure CLI, curl, or other non-Windows tools. The PowerShell runbook example is given first and exclusively, with no alternatives for Python or graphical runbooks, and Python webhook support is explicitly marked as unsupported.
Recommendations
- Add Linux/macOS examples using Bash and curl for REST API calls to create, update, and delete webhooks.
- Provide Azure CLI equivalents for all PowerShell Az Module commands (e.g., az automation webhook create, az automation job output).
- Include instructions and sample scripts for using webhooks from non-Windows environments, such as using curl or wget.
- Present cross-platform REST API usage with generic HTTP tools, not only PowerShell's Invoke-RestMethod.
- Clarify which steps/tools are platform-agnostic and which are Windows-specific.
- Where PowerShell is used, note how to install and use PowerShell Core (pwsh) on Linux/macOS, or offer alternatives.
- If Python runbooks are not supported with webhooks, suggest alternative runbook types for Linux users or clarify limitations.
Create Pull Request