Document Details
Automation Runbook Authoring
❌
This page contains Windows bias
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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows and PowerShell bias. Windows operating systems and PowerShell (especially Windows PowerShell 5.1) are mentioned first and most frequently. Directory path examples use Windows-style paths (e.g., C:\abc), and there are no Linux/macOS path examples. The documentation focuses on PowerShell runbooks and local debugging, with limited mention of Python and no Linux-specific instructions or examples. Linux and macOS are only briefly referenced in the supported OS list, with no parity in examples or troubleshooting.
Recommendations:
- Provide Linux/macOS-specific examples for directory paths (e.g., /home/user/abc) alongside Windows examples.
- Include instructions and screenshots for configuring the extension and running/debugging runbooks on Linux/macOS.
- List supported operating systems in a neutral or rotating order, not always starting with Windows.
- Expand Python runbook documentation, including debugging guidance for Linux/macOS users.
- Clarify any OS-specific limitations or differences in feature support.
- Ensure all command palette and settings navigation instructions are valid for Linux/macOS (e.g., keyboard shortcuts).
Create pull request