Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by frequently referencing Windows-specific tools (such as PowerShell cmdlets), providing detailed instructions for Windows before Linux, and omitting Linux equivalents for some operations. Most backup and export instructions rely on Windows PowerShell cmdlets, and Linux guidance is limited or absent for several tasks.
Recommendations
- Provide Linux CLI (e.g., Azure CLI, Bash) examples alongside or before Windows/PowerShell examples for all operations, such as exporting runbooks and DSC configurations.
- Include Linux-native tools and scripts for managing assets, backing up data, and other Automation account operations.
- Ensure parity in documentation depth and clarity for both Windows and Linux, avoiding the assumption that users are on Windows.
- Where only PowerShell cmdlets are available, explicitly note the lack of Linux alternatives and suggest workarounds or roadmap plans.
- Reorganize sections to avoid always listing Windows before Linux, or present both together in parallel tables or tabs.
Create Pull Request