Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias. Most example commands for enabling and updating VM extensions use PowerShell-specific syntax (e.g., powershell.exe and PowerShell cmdlets in the Custom Script Extension), and extension types and settings are frequently Windows-centric (e.g., IaaSAntimalware, DatadogWindowsAgent, DependencyAgentWindows). There is a lack of Linux-specific examples, such as Bash scripts or Linux extension types, and Windows tools/patterns are referenced more prominently and exclusively in examples.
Recommendations
- Provide parallel Linux examples for Custom Script Extension, using Bash or shell commands instead of PowerShell.
- Include extension examples for Linux-specific extensions (e.g., DependencyAgentLinux, DatadogLinuxAgent, KeyVaultForLinux).
- Alternate the order of examples so that Linux and Windows are equally represented and neither is always shown first.
- Explicitly mention differences in extension types and settings between Windows and Linux, and link to relevant Linux documentation.
- Add notes or tips for Linux/macOS users regarding command syntax, file paths, and shell differences.
Create Pull Request