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 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