Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
This documentation page provides step-by-step instructions for integrating NAT Gateway with Azure Firewall in a hub and spoke network, offering examples via the Azure Portal and PowerShell. PowerShell is featured as the sole command-line automation method, with no Bash, Azure CLI, or Linux-native scripting alternatives. Windows/PowerShell tools and patterns are used exclusively, and PowerShell examples are presented before any Linux-relevant CLI options. This creates friction for Linux/macOS users who typically use Bash or Azure CLI.
Recommendations
- Add equivalent Azure CLI (az) commands for each PowerShell example, ensuring parity for Linux/macOS users.
- Include Bash scripting examples where appropriate, especially for VM creation and network configuration.
- Explicitly mention that PowerShell can be used cross-platform, but highlight Azure CLI as the recommended option for Linux/macOS.
- Reorder examples so that Portal and CLI (az) instructions appear before PowerShell, or present all options side-by-side.
- Clarify prerequisites for Linux/macOS users, such as installing Azure CLI and using Bash.
- Avoid exclusive references to Windows tools (e.g., Get-Credential) and provide platform-neutral alternatives.
Create Pull Request