Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a strong bias toward Windows and PowerShell. All examples and instructions focus exclusively on PowerShell, PowerShell Gallery, and Windows-centric tools and patterns. There is no mention of Linux shell equivalents, Linux-specific modules, or cross-platform scripting approaches. Even in sections referencing Python, there are no concrete Linux or bash examples. The common scenarios and runbooks highlighted are Windows/PowerShell-centric, and the documentation does not address Linux automation workflows or provide parity for Linux users.
Recommendations
- Add examples and instructions for importing and using runbooks/modules with Linux tools (e.g., bash, Azure CLI, Python).
- Include Linux-specific runbook scenarios and modules, such as those for managing Linux VMs or using bash scripts.
- Mention and demonstrate cross-platform compatibility for runbooks and modules, clarifying which are usable on Linux and how to use them.
- Provide parity in documentation structure, ensuring Linux and Windows approaches are presented side-by-side or with equal prominence.
- Reference Linux automation best practices and tools (e.g., cron, systemd, shell scripting) where relevant.
- Clarify limitations and support for PowerShell Core (pwsh) on Linux, and provide guidance for Linux users where Azure Automation does not support PowerShell Core.
Create Pull Request