Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exclusively uses PowerShell for all examples and instructions, including setup, configuration, and runbook authoring. There are no examples or guidance for Linux users, such as using Python runbooks, Bash scripts, or Azure CLI equivalents. Windows-centric tools and patterns (e.g., PowerShell cmdlets, references to the Azure Az PowerShell module) are mentioned exclusively and before any cross-platform alternatives, which are not present at all.
Recommendations
- Provide equivalent examples using Python runbooks, which are supported in Azure Automation and are platform-agnostic.
- Include instructions and code snippets using Azure CLI for resource creation and management tasks (e.g., creating Key Vaults, assigning permissions), as Azure CLI is cross-platform.
- Add Bash script examples for users who prefer shell scripting, especially for automation tasks.
- Clearly indicate that PowerShell examples work on both Windows and Linux in Azure Automation, but also offer alternatives for users who may want to develop and test scripts locally on Linux/macOS.
- Reference cross-platform tools and modules (such as Azure CLI and REST API) alongside PowerShell, not just as an afterthought or in separate documentation.
- Consider reordering sections or providing parallel tracks so that Linux and cross-platform users do not feel secondary to Windows/PowerShell users.
Create Pull Request