Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides detailed PowerShell examples for managing network policies, which are Windows-centric. PowerShell is presented before Azure CLI, and the CLI section notes limitations compared to PowerShell. There is no mention of Bash, Linux shell, or cross-platform scripting alternatives. The examples and tool references (PowerShell cmdlets) are primarily Windows-focused, potentially creating friction for Linux/macOS users.
Recommendations
- Add Bash or shell script examples using Azure CLI to demonstrate parity and usage on Linux/macOS.
- Clarify that Azure CLI is cross-platform and provide guidance for installing and using it on Linux/macOS.
- Where PowerShell is referenced, mention that PowerShell Core is available on Linux/macOS, and provide equivalent examples if syntax differs.
- Avoid presenting Windows-centric tools (PowerShell) before cross-platform alternatives (CLI) unless there is a technical reason.
- Explicitly state platform compatibility for each tool and example.
Create Pull Request