Document Details
Waf App Gateway
❌
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
missing_linux_example
Summary:
The documentation exclusively uses Azure Portal (GUI) instructions and does not provide any command-line examples for either Windows (PowerShell/CLI) or Linux (Bash/CLI). However, this omission results in a bias of missing Linux parity, as many cross-platform users expect CLI (az CLI, Bash) instructions, especially for automation or Linux-first workflows. No Windows-specific tools or patterns are present, but the lack of CLI coverage is a form of implicit bias.
Recommendations:
- Add Azure CLI (az) command examples for all major steps, such as creating DNS zones, Application Gateway, backend pools, and configuring WAF. These CLI examples should be written in a cross-platform way (Bash syntax) to ensure Linux and macOS users are supported.
- Where possible, provide both Portal and CLI instructions side-by-side or in tabs, so users can choose their preferred workflow.
- Explicitly mention that all steps can be performed via CLI and link to relevant CLI documentation.
- If PowerShell is to be included, ensure Bash/az CLI equivalents are always present and not secondary.
- Highlight any steps that are only possible via the Portal, and provide workarounds or alternatives for CLI users.
Create pull request