Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a strong Windows bias by exclusively using PowerShell for all code examples, setup instructions, and runbook creation steps. Prerequisites and links reference Windows-centric resources (e.g., 'quick-create-powershell' for VMs, Azure Az PowerShell module), and there are no Bash, CLI, or Linux/macOS-specific instructions or examples. The workflow assumes users are familiar with PowerShell and does not mention or demonstrate how to accomplish the same tasks using Azure CLI, Bash, or other cross-platform tools.
Recommendations
- Provide equivalent examples using Azure CLI (az) commands, which are cross-platform and work on Linux/macOS.
- Include instructions for creating and managing Automation runbooks using Bash or shell scripts, where supported.
- Reference Linux/macOS VM creation guides alongside Windows guides in prerequisites.
- Clarify which steps are platform-agnostic (e.g., portal actions) and which require adaptation for non-Windows environments.
- Add notes or links for installing and using Azure CLI on Linux/macOS.
- Consider providing sample runbooks written in Python, which is supported in Azure Automation and is cross-platform.
Create Pull Request