Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page is heavily focused on PowerShell-based troubleshooting and examples, with nearly all code samples, cmdlet references, and troubleshooting steps using PowerShell or Windows-centric tools (e.g., PowerShell ISE, Windows Management Instrumentation). There is little to no mention of Linux-specific tools, shell environments, or cross-platform scripting approaches, and Linux alternatives are not provided or referenced. Python is mentioned only briefly, and no Linux shell (bash) examples or troubleshooting patterns are given.
Recommendations
- Provide equivalent troubleshooting steps and examples for Linux environments, including bash or Python scripts where applicable.
- Include guidance for users running Azure Automation runbooks from Linux machines, such as using Azure CLI, bash, or Python.
- Reference cross-platform tools (e.g., VS Code, Azure CLI) and clarify when steps are OS-agnostic.
- Add explicit notes or sections for Linux users, highlighting differences in module installation, authentication, and error handling.
- Ensure that troubleshooting steps do not assume the use of PowerShell or Windows-only tools, or provide alternatives for Linux users.
- Where PowerShell is required, mention PowerShell Core (pwsh) and its cross-platform capabilities, and provide examples for Linux/macOS.
Create Pull Request