Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples throughout, but PowerShell is featured equally or slightly more prominently than Azure CLI. In several sections, PowerShell examples are given immediately after CLI, and the PowerShell commands are Windows-centric (even though PowerShell Core is cross-platform, most Linux administrators use Bash/CLI). The documentation does not provide Bash-only or Linux-native command examples (other than waagent version check), and references to Azure PowerShell are frequent. While the page is focused on Linux VM extensions, the use of PowerShell and Windows-oriented tooling is notable.
Recommendations
- Prioritize Azure CLI examples and Bash scripts for Linux-focused documentation, as CLI is the primary tool for Linux users.
- Consider providing Bash-native examples for common operations (e.g., using curl/wget for script download, jq for JSON parsing).
- Move PowerShell examples to a secondary position or into expandable sections, making CLI the default.
- Clarify that Azure PowerShell can be used cross-platform, but highlight CLI as the recommended method for Linux users.
- Add troubleshooting and operational examples using Linux-native tools (e.g., systemctl, journalctl, grep) where relevant.
Create Pull Request