Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Windows First
Summary
The documentation page heavily focuses on PowerShell and Windows-centric tools and patterns. Most examples, parameter types, and workflows are presented using PowerShell, PowerShell Workflow, and graphical runbooks (which are also PowerShell-based). Windows/PowerShell terminology and tooling are referenced throughout, with only brief mention of Python runbooks. The examples for starting runbooks, passing parameters, and working with JSON objects are almost exclusively PowerShell-based, and Windows PowerShell features are discussed. There is little to no coverage of Linux/macOS-specific workflows or CLI tools (e.g., Bash, Azure CLI), and PowerShell examples are shown first and most frequently.
Recommendations
- Add equivalent examples using Azure CLI (bash) for assigning parameters and starting runbooks, especially for Linux/macOS users.
- Clarify that PowerShell examples can be run cross-platform (PowerShell Core), and note any Windows-specific limitations.
- Expand Python runbook examples to show parameter passing and invocation from Linux/macOS environments.
- Mention and demonstrate how to use REST API and SDKs from Linux/macOS, including sample shell commands (curl, jq) for REST calls.
- Balance the order of examples so that PowerShell and non-Windows approaches are presented equally or in parallel.