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
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows and PowerShell bias. Windows operating systems are listed first in the supported OS matrix, and all directory path examples use Windows-style paths (e.g., C:\abc). The documentation focuses heavily on PowerShell (including Windows PowerShell 5.1), with limited mention of Python and no mention of Bash or Linux-native scripting. There are no Linux/macOS-specific examples, and all configuration and usage patterns (such as changing directories) are described using Windows conventions.
Recommendations
- Provide Linux/macOS path examples (e.g., /home/user/abc) alongside Windows paths.
- List supported operating systems in a neutral or rotating order (e.g., Ubuntu, macOS, Windows) to avoid Windows-first bias.
- Include examples and instructions for Linux/macOS users, such as using the terminal or command palette on those platforms.
- Mention Linux-native tools or shell environments where relevant, and clarify any platform-specific behaviors.
- Expand Python-related documentation and provide parity in debugging and usage instructions for non-PowerShell runbooks.
Create Pull Request
Clean