Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a strong Windows and PowerShell bias. All command-line examples use Windows PowerShell and Az PowerShell cmdlets, with no mention of Bash, Azure CLI, or Linux-native scripting. The internal cmdlets and runbook examples are PowerShell-centric. The only alternative shown is Python, but there are no examples or guidance for Linux shell users or for using Azure CLI. Windows tools and terminology (e.g., 'Windows PowerShell', 'Windows Hybrid Runbook Worker') are referenced exclusively or before any cross-platform alternatives.
Recommendations
- Add equivalent examples using Azure CLI (az automation variable ...) for variable management, which works cross-platform.
- Include Bash or shell script examples for Linux users, especially for common tasks like creating, retrieving, and updating variables.
- When referencing PowerShell, clarify that Az PowerShell modules are available cross-platform, and provide explicit instructions for Linux/macOS environments.
- Avoid using 'Windows PowerShell' as the default term; use 'PowerShell' unless specifically referring to Windows-only features.
- Mention and provide guidance for running runbooks on Linux Hybrid Runbook Workers, not just Windows.
- Ensure that references to tools and workflows are not Windows-first; present cross-platform options in parallel or with equal prominence.
Create Pull Request