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, cmdlet references, and output retrieval instructions using PowerShell syntax and Windows-specific tools. There are no examples or guidance for Linux/macOS users, such as Bash, Python, or cross-platform Azure CLI usage. Windows terminology and tools are used exclusively and introduced first, creating friction for non-Windows users.
Recommendations
- Add equivalent examples using Azure CLI and/or REST API for retrieving runbook output and managing jobs, which are cross-platform.
- Include Python runbook examples and clarify how output and message streams work for Python and other supported languages.
- Provide guidance for Linux/macOS users on installing and using PowerShell Core (pwsh), or offer alternative workflows using Bash or other shells.
- Explicitly mention platform compatibility for cmdlets and features, and note any differences in behavior on non-Windows platforms.
- Reorder sections or provide parallel examples so that Linux/macOS options are presented alongside or before Windows-specific instructions.
Create Pull Request