kubernetes-sigs / kubernetes-sigs/gateway-api

Incorrect logic description in the HTTPHeaderName section

Open Beginner friendly
#4,480 7 comments 0 reactions 0 assignees View on GitHub
kind/documentation
Dominant language
Go
Stars
3k
Forks
789
Avg merge
2d 15h
Merged PRs (30d)
45

Description

**What would you like to be added**:

[Documentation for the HTTPHeaderName](https://gateway-api.sigs.k8s.io/reference/1.4/spec/#httpheader) states that

> If multiple entries specify equivalent header names, the first entry with an equivalent name MUST be considered for a match.

Actual behavior is that filters specifying equivalent header names are invalid, for example:

```
requestHeaderModifier:
add:
- name: my-header-name
value: my-header-value
- name: my-header-name
value: my-header-value2
```

So, if multiple entries specify equivalent header names, the respective HTTP/GRPCRoute will fail with `Duplicate value: map[string]interface {}{"name":"my-header-name"}`, so I assume the documentation should be aligned [with this description](https://github.com/kubernetes-sigs/gateway-api/pull/3778/changes)

Contributor guide

Open the contributing guide

Research direction

Start with the HTTPHeaderName section in the linked Gateway API reference and compare its statement with the behavior described in this issue. Read the changes in PR 3778 for the intended wording, then update the documentation so it reflects that equivalent header names are rejected; done means the section matches the documented validation behavior.

Written by the indexing model from the issue text.

Assessment

Domain
documentation, networking
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.