Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation exhibits a Windows bias in several areas. In code examples for enabling Automatic Extension Upgrade, the extension type shown is 'DependencyAgentWindows' in REST API, PowerShell, and ARM template samples, with Linux equivalents either omitted or shown only in CLI examples. PowerShell examples are provided, but Bash or Linux-native scripting is not. Windows extension types and tools (PowerShell cmdlets) are mentioned first or exclusively in several sections, and Linux examples are less prominent or missing, especially in PowerShell and template sections.
Recommendations
- Provide parallel examples for both Windows and Linux extension types in all code samples (REST API, PowerShell, ARM templates), not just CLI.
- Include Bash or Linux-native scripting examples alongside PowerShell for automation tasks.
- Alternate the order of Windows and Linux examples to avoid Windows-first presentation.
- Explicitly mention Linux support in all procedural steps, not just in summary tables.
- Where PowerShell is used, add equivalent instructions for Linux users (e.g., Azure CLI, Bash scripts).
Create Pull Request