Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation is heavily focused on Windows PowerShell, with all code examples, cmdlets, and patterns using PowerShell syntax and Windows-centric tooling. There is no mention of Linux/macOS equivalents, such as Bash, Python, or cross-platform Azure CLI commands. The retrieval of runbook output is described only with Windows PowerShell cmdlets, and preference variables are referenced as Windows PowerShell constructs. The documentation assumes familiarity with PowerShell and does not provide guidance for Linux/macOS users or cross-platform alternatives.
Recommendations
- Add equivalent examples using Azure CLI and/or REST API for retrieving runbook output and messages, which are cross-platform.
- Include references and examples for Python runbooks, especially since Python is mentioned as supported for output streams.
- Explicitly state platform requirements and limitations for PowerShell-based runbooks, and provide guidance for Linux/macOS users.
- Provide links to documentation for running and managing Azure Automation from Linux/macOS environments.
- Where possible, show both PowerShell and Bash/Azure CLI examples side-by-side.
- Clarify which features (such as preference variables) are PowerShell-specific and what alternatives exist for other languages/platforms.
Create Pull Request