Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation is heavily biased towards Windows and PowerShell. All code samples and authentication instructions use PowerShell, with no equivalent Bash, CLI, or Python examples for Linux/macOS users. The prerequisites and workflow mention both Windows and Linux VM extensions, but all automation and scripting guidance is Windows-centric. This creates friction for Linux/macOS users who may not have PowerShell installed or prefer native tools.
Recommendations
- Provide equivalent examples using Azure CLI, Bash, or Python for Linux/macOS users.
- Explicitly document how to perform authentication and environment variable setup on Linux/macOS, including key generation and encryption using OpenSSL or other native tools.
- Include guidance for installing and using PowerShell Core on Linux/macOS if PowerShell is required.
- Reorder examples or provide parallel sections for Windows and Linux/macOS, rather than presenting Windows/PowerShell first and exclusively.
- Mention and link to Linux-native packet capture tools (e.g., tcpdump) where relevant, and clarify how Azure Network Watcher interacts with Linux VMs.
Create Pull Request