Switch back from /enhancements to /geps

iromanycheva-eng · iromanycheva-eng · commit 8aa304a8efbf · 2026-04-18T05:04:36.000Z
diff --git a/Makefile b/Makefile
@@ -46,7 +46,7 @@ export COMMIT ?= $(shell git rev-parse --short HEAD)
 DOCKER ?= docker
 # TOP is the current directory where this Makefile lives.
 TOP := $(dir $(firstword $(MAKEFILE_LIST)))
-# ROOT is the root of the mkdocs tree.
+# ROOT is the root of the documentation tree.
 ROOT := $(abspath $(TOP))
 
 # Command-line flags passed to "go test" for the conformance
@@ -109,7 +109,7 @@ test:
 .PHONY: tidy
 tidy:
 	go work sync
-	find . -name go.mod -execdir sh -c 'go mod tidy' \;
+	find . -name go.mod -not -path "./site/*" -exec sh -c 'cd "$$(dirname "{}")" && go mod tidy' \;
 
 # Run tests for CRDs validation
 .PHONY: test.crds-validation
@@ -194,7 +194,6 @@ release-staging: image.multiarch.setup
 
 PYTHON ?= $(shell if [ -x .venv/bin/python3 ]; then echo "./.venv/bin/python3"; else echo "python3"; fi)
 
-DOCS_BUILD_CONTAINER_NAME ?= gateway-api-mkdocs
 DOCS_VERIFY_CONTAINER_IMAGE ?= registry.hub.docker.com/lycheeverse/lychee:0.23
 
 # Build the documentation.
@@ -203,12 +202,12 @@ docs:
 	hack/make-hugo-docs.sh
 
 .PHONY: build-docs
-build-docs: update-geps api-ref-docs
-	docker run --rm -v ${PWD}:/src -w /src/site peaceiris/hugo:v0.148.0-extended hugo
+build-docs: update-geps api-ref-docs wizard-wasm wizard-data conformance-data
+	hugo --source site
 
 .PHONY: verify-docs
 verify-docs: build-docs
-	docker run --init --rm -w /input -v ${PWD}:/input $(DOCS_VERIFY_CONTAINER_IMAGE) --root-dir /input/site/public --exclude-path "overrides/partials/.*\.html" --exclude ".*" --include "sigs.k8s.io" --accept 200 --max-concurrency 10 --include-fragments --cache $(VALIDATE_DOCS_EXTRA_ARGS) /input/site/public/**/*.html
+	docker run --init --rm -w /input -v ${PWD}:/input $(DOCS_VERIFY_CONTAINER_IMAGE) --root-dir /input/site/public --include "sigs.k8s.io" --accept 200 --max-concurrency 10 --include-fragments --cache $(VALIDATE_DOCS_EXTRA_ARGS) /input/site/public/**/*.html
 
 .PHONY: build-docs-netlify
 build-docs-netlify: update-geps api-ref-docs wizard-wasm wizard-data conformance-data
diff --git a/geps/gep-1016/index.md b/geps/gep-1016/index.md
@@ -7,7 +7,7 @@
 > our GEP overview as it existed before those rules did, and so it has been
 > explicitly grandfathered in.
 
-[expprob]:/enhancements/overview/#probationary-period
+[expprob]:/geps/overview/#probationary-period
 
 ## Goal
 
diff --git a/geps/gep-1323/index.md b/geps/gep-1323/index.md
@@ -7,7 +7,7 @@
 > our GEP overview as it existed before those rules did, and so it has been
 > explicitly grandfathered in.
 
-[expprob]:/enhancements/overview/#probationary-period
+[expprob]:/geps/overview/#probationary-period
 
 ## TLDR
 Similar to how we have `RequestHeaderModifier` in `HTTPRouteFilter`, which lets users modify request headers before the request is forwarded to a backend (or a group of backends), it’d be helpful to have a `ResponseHeaderModifier` field which would let users modify response headers before they are returned to the client.
diff --git a/geps/gep-1324/index.md b/geps/gep-1324/index.md
@@ -7,7 +7,7 @@
 > of our GEP overview as it existed before those rules did, and so it has been
 > explicitly grandfathered in.
 
-[expprob]:/enhancements/overview/#probationary-period
+[expprob]:/geps/overview/#probationary-period
 
 ## Overview
 
diff --git a/geps/gep-1494/index.md b/geps/gep-1494/index.md
@@ -3,7 +3,7 @@
 * Issue: [#1494](https://github.com/kubernetes-sigs/gateway-api/issues/1494)
 * Status: Experimental
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 
 ## TLDR
diff --git a/geps/gep-1619/index.md b/geps/gep-1619/index.md
@@ -3,7 +3,7 @@
 * Issue: [#1619](https://github.com/kubernetes-sigs/gateway-api/issues/1619)
 * Status: Experimental
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## Graduation Criteria
 
@@ -1227,7 +1227,7 @@ Though session persistence is a ubiquitous name, session affinity is more incons
 - [LBPolicy](https://static.sched.com/hosted_files/kccnceu2023/c4/Autoscaling%20Elastic%20Kubernetes%20Infrastructure%20for%20Stateful%20Applications%20using%20Proxyless%20gRPC%20and%20Istio.pdf#page=25) (proposed extension for session persistence API)
 - [gRPC Stateful Session Affinity Proposal](https://github.com/grpc/proposal/blob/master/A55-xds-stateful-session-affinity.md) (info on session draining and session persistence in gRPC)
 - [Kube-Proxy Session Affinity](https://kubernetes.io/docs/reference/networking/virtual-ips/#session-affinity)
-- [GEP-713: Metaresources and PolicyAttachment](/enhancements/geps/gep-713/)
+- [GEP-713: Metaresources and PolicyAttachment](/geps/gep-713/)
 - [RFC6265](https://www.rfc-editor.org/rfc/rfc6265)
 - [Policy Attachment](/reference/policy-attachment)
 - [Envoy Session Persistence Design Doc](https://docs.google.com/document/d/1IU4b76AgOXijNa4sew1gfBfSiOMbZNiEt5Dhis8QpYg/edit#heading=h.sobqsca7i45e)
diff --git a/geps/gep-1651/index.md b/geps/gep-1651/index.md
@@ -3,7 +3,7 @@
 * Issue: [#1651](https://github.com/kubernetes-sigs/gateway-api/issues/1651)
 * Status: Provisional
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-1713/index.md b/geps/gep-1713/index.md
@@ -3,7 +3,7 @@
 * Issue: [#1713](https://github.com/kubernetes-sigs/gateway-api/issues/1713)
 * Status: Standard
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## Introduction
 
diff --git a/geps/gep-1731/index.md b/geps/gep-1731/index.md
@@ -3,7 +3,7 @@
 * Issue: [#1731](https://github.com/kubernetes-sigs/gateway-api/issues/1731)
 * Status: Experimental
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-1742/index.md b/geps/gep-1742/index.md
@@ -3,7 +3,7 @@
 * Issue: [#1742](https://github.com/kubernetes-sigs/gateway-api/issues/1742)
 * Status: Standard
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-1748/index.md b/geps/gep-1748/index.md
@@ -13,7 +13,7 @@ This GEP is also exempt from the [Probationary Period][expprob] rules as it
 predated them.
 {{< /details >}}
 
-[expprob]:/enhancements/overview/#probationary-period
+[expprob]:/geps/overview/#probationary-period
 
 ## TLDR
 
diff --git a/geps/gep-1911/index.md b/geps/gep-1911/index.md
@@ -3,7 +3,7 @@
 * Issue: [#1911](https://github.com/kubernetes-sigs/gateway-api/issues/1911)
 * Status: Standard
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-2648/index.md b/geps/gep-2648/index.md
@@ -3,7 +3,7 @@
 * Issue: [#2648](https://github.com/kubernetes-sigs/gateway-api/issues/2648)
 * Status: Declined
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-2649/index.md b/geps/gep-2649/index.md
@@ -3,7 +3,7 @@
 * Issue: [#2649](https://github.com/kubernetes-sigs/gateway-api/issues/2649)
 * Status: Declined
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-2659/index.md b/geps/gep-2659/index.md
@@ -4,7 +4,7 @@
 * Type: Memorandum
 * Status: Accepted
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-3171/index.md b/geps/gep-3171/index.md
@@ -3,7 +3,7 @@
 * Issue: [#3171](https://github.com/kubernetes-sigs/gateway-api/issues/3171)
 * Status: Standard
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-3388/index.md b/geps/gep-3388/index.md
@@ -3,7 +3,7 @@
 * Issue: [#3388](https://github.com/kubernetes-sigs/gateway-api/issues/3388)
 * Status: Experimental
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-3779/index.md b/geps/gep-3779/index.md
@@ -3,7 +3,7 @@
 * Issue: [#3779](https://github.com/kubernetes-sigs/gateway-api/issues/3779)
 * Status: Implementable
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-3792/index.md b/geps/gep-3792/index.md
@@ -3,7 +3,7 @@
 * Issue: [#3792](https://github.com/kubernetes-sigs/gateway-api/issues/3792)
 * Status: Provisional
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## User Story
 
diff --git a/geps/gep-3793/index.md b/geps/gep-3793/index.md
@@ -3,7 +3,7 @@
 * Issue: [#3793](https://github.com/kubernetes-sigs/gateway-api/issues/3793)
 * Status: Implementable
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD",
 "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this
diff --git a/geps/gep-3798/index.md b/geps/gep-3798/index.md
@@ -3,7 +3,7 @@
 * Issue: [#3798](https://github.com/kubernetes-sigs/gateway-api/issues/3798)
 * Status: Deferred
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## Notes and Disclaimers
 
diff --git a/geps/gep-3949/index.md b/geps/gep-3949/index.md
@@ -3,7 +3,7 @@
 * Issue: [#3949](https://github.com/kubernetes-sigs/gateway-api/issues/3949)
 * Status: Implementable
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 [Chihiro]: /docs/concepts/roles-and-personas/#chihiro
 [Ian]: /docs/concepts/roles-and-personas/#ian
diff --git a/geps/gep-696/index.md b/geps/gep-696/index.md
@@ -3,7 +3,7 @@
 * Issue: [#696](https://github.com/kubernetes-sigs/gateway-api/issues/696)
 * Status: Provisional|Prototyping|Implementable|Experimental|Standard|Completed|Memorandum|Deferred|Declined|Withdrawn
 
-(See [status definitions](/enhancements/overview/#gep-states).)
+(See [status definitions](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/geps/gep-713/index.md b/geps/gep-713/index.md
@@ -3,7 +3,7 @@
 * Issue: [#713](https://github.com/kubernetes-sigs/gateway-api/issues/713)
 * Status: Memorandum
 
-(See status definitions [here](/enhancements/overview/#gep-states))
+(See status definitions [here](/geps/overview/#gep-states))
 
 ## TL;DR
 
diff --git a/geps/gep-91/index.md b/geps/gep-91/index.md
@@ -3,7 +3,7 @@
 * Issue: [#91](https://github.com/kubernetes-sigs/gateway-api/issues/91)
 * Status: Standard
 
-(See definitions in [GEP States](/enhancements/overview/#gep-states).)
+(See definitions in [GEP States](/geps/overview/#gep-states).)
 
 ## TLDR
 
diff --git a/hack/update-geps.sh b/hack/update-geps.sh
@@ -22,5 +22,5 @@ SCRIPT_ROOT=$(dirname "${BASH_SOURCE}")/..
 
 GEPS_TOC_SKIP="${GEPS_TOC_SKIP:-696}"
 GEPS_TOC_DIR=${GEPS_TOC_DIR:-${SCRIPT_ROOT}/geps}
-MD_DEST_DIR=${SCRIPT_ROOT}/site/content/en/enhancements/
+MD_DEST_DIR=${SCRIPT_ROOT}/site/content/en/geps/
 go run tools/geps/main.go -g "${GEPS_TOC_DIR}/" -s "${GEPS_TOC_SKIP}" -o "${MD_DEST_DIR}"
diff --git a/site/content/en/contributing/enhancement-requests.md b/site/content/en/contributing/enhancement-requests.md
@@ -51,7 +51,7 @@ include reference to a discussion and/or recordings of discussion in our
 community meetings, please note that it _may_ get closed with a request to
 create an initial discussion first.
 
-[gep]: /enhancements/overview/
+[gep]: /geps/overview/
 [discussion]: https://github.com/kubernetes-sigs/gateway-api/discussions/new/choose
 [meetings]: /contributing/get-involved/#meetings
 
diff --git a/site/content/en/docs/concepts/versioning.md b/site/content/en/docs/concepts/versioning.md
@@ -18,7 +18,7 @@ point, these may graduate to the Standard release channel or be dropped from the
 API entirely.
 
 The following diagram provides a high level overview of the lifecycle of a
-feature or resource proposed by a new [GEP](/enhancements/overview/) (enhancement
+feature or resource proposed by a new [GEP](/geps/overview/) (enhancement
 proposal) in Gateway API:
 
 ```mermaid
diff --git a/site/content/en/docs/mesh/gamma.md b/site/content/en/docs/mesh/gamma.md
@@ -46,7 +46,7 @@ The simplest way to get started is to attend one of the regular Gateway API
 [service mesh]: /docs/glossary/#service-mesh
 [east/west traffic]: /docs/glossary/#eastwest-traffic
 [role-oriented]: /docs/concepts/roles-and-personas/
-[geps]: /enhancements/overview/
+[geps]: /geps/overview/
 [contributor-ladder]: /contributing/contributor-ladder/
 [meetings]: /contributing/get-involved/#meetings
 [GAMMA leads]: https://github.com/kubernetes-sigs/gateway-api/blob/main/OWNERS_ALIASES#L23
diff --git a/site/content/en/geps/_index.md b/site/content/en/geps/_index.md
diff --git a/site/content/en/geps/by-state/.gitignore b/site/content/en/geps/by-state/.gitignore
diff --git a/site/content/en/geps/by-state/_index.md b/site/content/en/geps/by-state/_index.md
diff --git a/site/content/en/geps/list/.gitignore b/site/content/en/geps/list/.gitignore
diff --git a/site/content/en/geps/overview.md b/site/content/en/geps/overview.md
diff --git a/site/content/en/reference/policy-attachment.md b/site/content/en/reference/policy-attachment.md
@@ -17,5 +17,5 @@ A "Policy Attachment" is a specific type of _metaresource_ that can affect speci
 settings across either one object (this is "Direct Policy Attachment"), or objects
 in a hierarchy (this is "Inherited Policy Attachment").
 
-This pattern is EXPERIMENTAL, and is described in [GEP-713](/enhancements/geps/gep-713/index.md).
+This pattern is EXPERIMENTAL, and is described in [GEP-713](/geps/gep-713/index.md).
 Please see that document for technical details.
diff --git a/site/hugo.toml b/site/hugo.toml
@@ -90,7 +90,7 @@ defaultContentLanguage = "en"
 [[menu.main]]
     name = "Enhancements"
     weight = 40
-    url = "/enhancements/"
+    url = "/geps/"
 
 [[menu.main]]
     name = "Contributing"
@@ -110,5 +110,5 @@ defaultContentLanguage = "en"
 
   [[module.mounts]]
     source = "../geps"
-    target = "content/enhancements/geps"
+    target = "content/geps"
  
diff --git a/site/static/_redirects b/site/static/_redirects
@@ -16,11 +16,9 @@
 /reference/api-spec/1.5/  /reference/api-spec/1.5/spec/    301!
 /reference/api-spec/1.4/  /reference/api-spec/1.4/spec/    301!
 
-/enhancements/  /enhancements/overview/    301!
-/enhancements/by-state/  /enhancements/by-state/standard/    301!
+/geps/  /geps/overview/    301!
+geps/by-state/ /geps/by-state/standard/    301!
 
-/geps/*  /enhancements/geps/:splat  301!
-/enhancements/geps/  /enhancements/list/  301!
 
 /contributing/  /contributing/get-involved/    301!
 
diff --git a/tools/geps/main.go b/tools/geps/main.go
@@ -74,7 +74,7 @@ const kindDetails = "GEPDetails"
 func main() {
 	flag.StringVar(&GEPSDir, "g", "", "Defines the absolute path of the directory containing the GEPs")
 	flag.StringVar(&SkipGEPNumber, "s", "696", "Defines GEPs number to be skipped, should be comma-separated")
-	flag.StringVar(&OutDir, "o", "", "Defines the absolute path of the output directory (e.g., site/content/en/enhancements/list)")
+	flag.StringVar(&OutDir, "o", "", "Defines the absolute path of the output directory (e.g., site/content/en/geps/list)")
 
 	flag.Parse()
 
@@ -234,9 +234,9 @@ func walkGEPs(dir string, skipGEPs []string) (GEPArray, error) {
 
 func addFrontMatter(buf *bytes.Buffer, title string, weight int) {
 	buf.WriteString("---\n")
-	buf.WriteString(fmt.Sprintf("title: %q\n", title))
+	fmt.Fprintf(buf, "title: %q\n", title)
 	if weight > 0 {
-		buf.WriteString(fmt.Sprintf("weight: %d\n", weight))
+		fmt.Fprintf(buf, "weight: %d\n", weight)
 	}
 	buf.WriteString("---\n\n")
 }
