Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a strong Windows bias by exclusively using PowerShell cmdlets (e.g., Connect-AzAccount, Get-AzVM, Connect-AzureRMAccount) and PowerShell scripting for troubleshooting and examples. There are no examples or guidance for Linux-based automation, Bash, Azure CLI, or cross-platform scripting. The troubleshooting steps and error messages are all tailored to Windows-centric tools and workflows, potentially excluding Linux users or those using non-PowerShell environments.
Recommendations
- Add equivalent troubleshooting steps and examples using Azure CLI (az) commands and Bash scripts, especially for authentication and role assignment scenarios.
- Include sample error messages and resolutions that might be encountered when running runbooks on Linux Hybrid Runbook Workers.
- Explicitly mention that the guidance applies to both Windows and Linux automation environments, or clarify any platform-specific limitations.
- Provide links to cross-platform documentation or best practices for using managed identities in Linux-based automation.
- Ensure that all code samples are available in both PowerShell and Bash/Azure CLI where possible.
Create Pull Request