Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides detailed PowerShell examples for managing network policies, which are primarily Windows-centric. PowerShell is featured as a main method, with explicit code samples and references to Windows-specific cmdlets. There is no mention of Linux/macOS equivalents for PowerShell, nor any guidance for using PowerShell Core cross-platform. The Azure CLI is included, which is cross-platform, but its example is less flexible and lacks parity with the PowerShell example. PowerShell examples are presented before CLI examples, reinforcing a Windows-first approach.
Recommendations
- Clarify that Azure PowerShell can be used on Linux/macOS via PowerShell Core, and provide installation instructions or links.
- Provide Bash and/or shell script examples for Linux/macOS users where possible, especially for tasks that are more flexible in PowerShell.
- Ensure CLI examples have feature parity with PowerShell examples, or note limitations and provide workarounds.
- Consider presenting CLI examples before PowerShell, or in parallel, to avoid Windows-first ordering.
- Explicitly state platform compatibility for each method (Portal, PowerShell, CLI, ARM template).
Create Pull Request