About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a strong Windows and PowerShell bias. All command-line examples for creating and managing connections use PowerShell cmdlets, with no mention of Bash, Azure CLI, or Linux-native tools. The 'Create a new connection' section provides only a Windows PowerShell example, and the PowerShell tab appears before the Python tab in code samples. There is no guidance for users working from Linux or macOS environments, nor are cross-platform command-line alternatives (such as Azure CLI) presented.
Recommendations:
- Add equivalent Azure CLI examples for creating and managing Automation connections, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Include explicit instructions or notes for users on Linux/macOS, clarifying how they can perform the same tasks without PowerShell.
- Reorder or parallelize example sections so that PowerShell and Python (or CLI) examples are presented side-by-side, or at least do not always lead with Windows/PowerShell.
- Mention and link to any relevant Linux tools or scripts that can interact with Azure Automation, if available.
- Clarify in the introduction that the documented PowerShell cmdlets are available cross-platform (if true), or specify platform limitations.
- Where GUI steps are described, note any differences or limitations for users accessing the Azure portal from non-Windows systems.
Create pull request