Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a strong Windows/PowerShell bias. All command-line examples for managing connections (creation, retrieval, etc.) are provided exclusively using PowerShell cmdlets (Az module), with no mention of Bash, Azure CLI, or Linux-native tools. The workflow for creating connections outside the portal is described only for Windows PowerShell, and the internal cmdlets are PowerShell-centric. Python is supported for runbooks, but only within the context of Azure Automation, not for asset management from the command line. There are no examples or guidance for Linux users or those preferring cross-platform CLI tools.
Recommendations
- Add equivalent Azure CLI (az) examples for creating, retrieving, and managing Automation connections, as Azure CLI is cross-platform and widely used on Linux.
- Explicitly mention that PowerShell examples work on both Windows and Linux (with PowerShell Core), or clarify any platform-specific limitations.
- Provide Bash or shell script snippets where appropriate, especially for tasks that can be automated outside of PowerShell.
- Include a section or note for Linux/macOS users, outlining supported tools and any differences in workflow.
- Where possible, reference REST API usage for connection management, as this is platform-agnostic.
- Ensure that all steps and screenshots are not Windows-specific (e.g., avoid referencing Windows-only UI elements or terminology).
Create Pull Request