Repository navigation
docs: add front matter to GEP pages to fix search links - #4868
Merged
Merged
Conversation
Contributor
Author
gcs278
force-pushed
the
fix/gep-search-titles
branch
from
May 15, 2026 17:04
aa37449 to
fa3f6fd
Compare
GEP index.md files lacked Hugo front matter, causing empty titles in the Docsy search index. Search results showed the path (e.g. /geps/gep-1619) as plain text with no clickable link. Replace the markdown H1 heading with a front matter title field, matching the pattern used by all other site content pages. Additionally, hide individual GEP pages from the sidebar since they're already accessible via the GEPs List and search.
gcs278
force-pushed
the
fix/gep-search-titles
branch
from
May 15, 2026 17:09
fa3f6fd to
6bda6c7
Compare
Contributor
Author
|
Fixed. |
Member
|
/lgtm |
Contributor
|
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: gcs278, rikatz The full list of commands accepted by this bot can be found here. The pull request process is described here DetailsNeeds approval from an approver in each of these files:
Approvers can indicate their approval by writing |
gcs278
added a commit
to gcs278/gateway-api
that referenced
this pull request
Aug 14, 2026
These two GEPs were added after kubernetes-sigs#4868 and still used a markdown H1 heading for their title, which causes empty titles in the Docsy search index. Replace the H1 with a Hugo front matter title field, matching the pattern applied to all other GEP pages in kubernetes-sigs#4868.
gcs278
added a commit
to gcs278/gateway-api
that referenced
this pull request
Aug 14, 2026
Add hack/verify-gep-frontmatter.sh, run automatically by hack/verify-all.sh, asserting every geps/gep-*/index.md begins with a Hugo front matter block containing a title field. This prevents the old markdown H1 title style from regressing, which produces empty titles in the Docsy search index (see kubernetes-sigs#4868).
kubernetes-prow Bot
pushed a commit
that referenced
this pull request
Aug 17, 2026
* docs: add front matter to GEP-4359 and GEP-5093 pages These two GEPs were added after #4868 and still used a markdown H1 heading for their title, which causes empty titles in the Docsy search index. Replace the H1 with a Hugo front matter title field, matching the pattern applied to all other GEP pages in #4868. * hack: verify GEP index.md files use front matter titles Add hack/verify-gep-frontmatter.sh, run automatically by hack/verify-all.sh, asserting every geps/gep-*/index.md begins with a Hugo front matter block containing a title field. This prevents the old markdown H1 title style from regressing, which produces empty titles in the Docsy search index (see #4868).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

What type of PR is this?
/kind documentation
What this PR does / why we need it:
GEP index.md files lacked Hugo front matter, causing empty titles in the Docsy search index. Search results showed the path (e.g. /geps/gep-1619) as plain text with no clickable link. Replace the markdown H1 heading with a front matter title field, matching the pattern used by all other site content pages.
Additionally, hide individual GEP pages from the sidebar since they're already accessible via the GEPs List and search.
Which issue(s) this PR fixes:
Fixes # N/A
Does this PR introduce a user-facing change?:
Related: #4734