Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a notable Windows bias. Most code examples for enabling and updating VM extensions use Windows-specific tools (e.g., powershell.exe) and Windows-centric extension types (e.g., IaaSAntimalware, DatadogWindowsAgent, DependencyAgentWindows). There are no equivalent Linux shell script examples or Linux-specific extension types shown, and the examples consistently use Windows tools and patterns first or exclusively. This creates friction for Linux users who may not know how to adapt these examples for bash or Linux environments.
Recommendations
- Provide Linux-specific examples alongside Windows ones, such as using bash or sh in Custom Script Extension settings.
- Include extension types and settings for popular Linux VM extensions (e.g., DependencyAgentLinux, DatadogLinuxAgent, KeyVaultForLinux).
- When showing commandToExecute, alternate between Windows (powershell.exe) and Linux (bash -c) examples.
- Explicitly mention differences in extension types and settings between Windows and Linux, and link to documentation for Linux extensions.
- Ensure that the first example in each section is either neutral or alternates between Windows and Linux.
Create Pull Request