Add filter compatibility documenation

kubernetes-sigs · May 14, 2022 · d854f3d · d854f3d
1 parent db1797e
commit d854f3d
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/apis/v1alpha2/httproute_types.go b/apis/v1alpha2/httproute_types.go
@@ -182,6 +182,12 @@ type HTTPRouteRule struct {
 	// Specifying a core filter multiple times has unspecified or custom
 	// conformance.
 	//
+	// All filters are expected to be compatible with each other except for the
+	// URLRewrite and RequestRedirect filters, which may not be combined. If an
+	// implementation can not support other combinations of filters, they must clearly
+	// document that limitation. In all cases where incompatible or unsupported
+	// filters are specified, implementations MUST add a warning condition to status.
+	//
 	// Support: Core
 	//
 	// +optional

diff --git a/site-src/v1alpha2/api-types/httproute.md b/site-src/v1alpha2/api-types/httproute.md
@@ -126,6 +126,12 @@ Conformance levels are defined by the filter type:
 
 Specifying a core filter multiple times has unspecified or custom conformance.
 
+All filters are expected to be compatible with each other except for the
+URLRewrite and RequestRedirect filters, which may not be combined. If an
+implementation can not support other combinations of filters, they must clearly
+document that limitation. In all cases where incompatible or unsupported
+filters are specified, implementations MUST add a warning condition to status.
+
 #### BackendRefs (optional)
 
 BackendRefs defines API objects where matching requests should be sent. If