Bias Analysis
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. All examples use PowerShell syntax and cmdlets (e.g., Start-AzAutomationRunbook, Get-AzVM), with no mention of Linux/macOS alternatives or Bash/CLI equivalents. Windows/PowerShell terminology and modules are referenced exclusively and repeatedly, and there are no examples or guidance for users working with Python, Bash, or other cross-platform scripting environments. This creates friction for Linux/macOS users who may not use PowerShell as their primary automation language.
Recommendations
- Add equivalent examples using Azure CLI and Bash, which are cross-platform and commonly used on Linux/macOS.
- Explicitly mention platform support and limitations for runbook types (e.g., clarify if only PowerShell is supported, or if Python runbooks are possible).
- Provide guidance or links for users who want to author runbooks in Python or other supported languages.
- Reorder or balance examples so that PowerShell and CLI/Bash are presented equally, or clarify that PowerShell is required if that is the case.
- Note any OS-specific behaviors or requirements, especially where Windows/PowerShell features do not translate to Linux/macOS.
Create Pull Request