Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
While the documentation is focused on managing the Network Watcher Agent extension for Linux VMs, it consistently presents PowerShell (a Windows-centric tool) as a primary management interface, with detailed instructions and references to installing Azure PowerShell locally. The use of PowerShell is emphasized alongside Azure CLI, but PowerShell is often listed first, and its usage is described in more detail. There are also references to Windows-style tooling and patterns (e.g., PowerShell cmdlets, Cloud Shell), which may create friction for Linux users who typically prefer Bash or native Linux tools.
Recommendations
- Present Azure CLI examples before PowerShell examples, as CLI is more native to Linux environments.
- Reduce emphasis on PowerShell and Windows tooling in Linux-focused documentation. Where PowerShell is mentioned, clarify that Azure CLI is the recommended approach for Linux users.
- Add Bash script examples for common tasks, especially for installation and management steps.
- Highlight that Azure CLI can be installed natively on Linux and macOS, and provide links to Bash shell usage.
- Review and update instructions to avoid assuming users have access to PowerShell or Windows tools.
Create Pull Request