Skip to content

Commit 45ce0a8

Browse files
committed
Add review feedback
1 parent 5f159e5 commit 45ce0a8

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

site/content/how-to/traffic-management/snippets-filters.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,19 @@ This topic introduces Snippets and how to implement them using the `SnippetsFilt
1111

1212
## Overview
1313

14-
Snippets allow Cluster Operators to insert NGINX configuration into different contexts of the
14+
Snippets allow users to insert NGINX configuration into different contexts of the
1515
NGINX configurations that NGINX Gateway Fabric generates.
1616

1717
Snippets are for advanced NGINX users who need more control over the generated NGINX configuration,
18-
and can be used in cases where Gateway API resources or NGINX extensions don't apply.
18+
and can be used in cases where Gateway API resources or NGINX extensions policies don't apply.
1919

2020
---
2121

2222
## Disadvantages of Snippets
2323

24+
{{< warning >}} We recommend managing NGINX configuration through Gateway API resources, [first-class policies]({{< relref "overview/custom-policies.md" >}}), and other existing NGINX extensions
25+
before using Snippets. {{< /warning >}}
26+
2427
Snippets are configured using the `SnippetsFilter` API, but are disabled by default due to their complexity and security implications.
2528

2629
To use Snippets, set the `nginxGateway.snippetsFilters.enable` command line argument to true.
@@ -35,9 +38,6 @@ Snippets have the following disadvantages:
3538

3639
{{< note >}} If the NGINX configuration includes an invalid Snippet, NGINX will continue to operate with the last valid configuration. {{< /note >}}
3740

38-
Due to the described disadvantages of Snippets, we recommend exhausting all other means of NGINX configuration through Gateway API resources,
39-
[first-class policies]({{< relref "overview/custom-policies.md" >}}), and other NGINX extensions before using Snippets.
40-
4141
{{< note >}} If you end up using Snippets and run into situations where an NGINX directive fails to be applied, please create an issue in the
4242
[NGINX Gateway Fabric Github repository](https://github.com/nginxinc/nginx-gateway-fabric). {{< /note >}}
4343

@@ -272,7 +272,7 @@ spec:
272272
EOF
273273
```
274274

275-
This `SnippetFilter` is the same as the one applied to the coffee HTTPRoute, however it removes the `nodelay` setting
275+
This `SnippetsFilter` is the same as the one applied to the coffee HTTPRoute, however it removes the `nodelay` setting
276276
on the `limit_req` directive. This forces a delay on the incoming requests to match the rate set in `limit_req_zone`.
277277

278278
Verify that the `SnippetsFilter` is Accepted:

0 commit comments

Comments
 (0)