Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Windows First
Summary
The documentation is heavily focused on PowerShell and Windows-centric tools and patterns. Nearly all code examples, parameter handling, and automation scenarios are shown using PowerShell or C#, with no equivalent examples for Linux/macOS shells (e.g., Bash, Azure CLI). The only non-PowerShell runbook type discussed is Python, but even there, examples are minimal and lack parity with PowerShell sections. There are no Bash or Azure CLI examples for starting runbooks or passing parameters, and the workflow for Linux/macOS users is not addressed. The documentation assumes PowerShell as the primary interface for both authoring and invoking runbooks.
Recommendations
- Add Azure CLI examples for starting runbooks and passing parameters, showing equivalent workflows to the PowerShell cmdlets.
- Include Bash shell examples for interacting with the REST API (e.g., using curl or httpie) to start runbooks and pass parameters.
- Provide guidance for Linux/macOS users on installing and using Azure PowerShell (if required), or clarify when PowerShell Core (cross-platform) is supported.
- Expand the Python runbook section with more detailed examples, including parameter handling and invocation from non-Windows environments.
- Clearly indicate when features or cmdlets are Windows-only, and suggest cross-platform alternatives where available.