Docs release for 1.2.x

.github/ISSUE_TEMPLATE/release.md

@@ -14,7 +14,15 @@ assignees: ''
 
 - [ ] Confirm that the upgrade and release note pages are updated. Typically, this is a separate issue.
 - [ ] In `content/docs`, create the new `main` by making a copy of the current main directory. Rename the directories appropriately. For example, the old main is copied to a new `main`, the old main becomes `latest`, and the old latest version gets deleted (agentgateway only maintains `n` latest and `n+1` main in development).
+- [ ] For the _index.md pages of each version, update the version in the title.
 - [ ] In the `latest` version of the `content/docs` you just copied, update the test paths from `main` to `latest`.
+  Example search:
+  ```
+  In ./website/content/docs/standalone/latest
+  Find file: content/docs/standalone/main/
+  Replace with file: content/docs/standalone/latest/
+  # and repeat for kubernetes
+  ```
 - [ ] In the `hugo.yaml` file, update the `versions` to include the new minor version as main, the previous main as latest, and the previous latest as its version.
 - [ ] Update the version conrefs in the `assets/docs/versions` directory. Often, there is not a release for the next version, so you might have to use the same for latest and main.
 - [ ] Add the release date to the version table in `assets/docs/pages/reference/versions.md`, and remove any retired versions.

assets/agw-docs/pages/observability/control-plane-metrics.md

@@ -65,9 +65,9 @@ Helpful terms:
 
 * Transform: The process of the control plane converting high-level resources or intermediate representations (IR) into lower-level representations into the structure that the XDS API expects for a snapshot.
 
-{{< version include-if="1.1.x" >}}
+{{< version include-if="1.2.x" >}}
 {{< reuse "agw-docs/snippets/metrics-control-plane-latest.md" >}}
 {{< /version >}}
-{{< version include-if="1.2.x" >}}
+{{< version include-if="1.3.x" >}}
 {{< reuse "agw-docs/snippets/metrics-control-plane-main.md" >}}
 {{< /version >}}

assets/agw-docs/pages/reference/versions.md

@@ -4,6 +4,7 @@ Review the following information about supported release versions for the [agent
 
 | agentgateway | Release date | Kubernetes | Gateway API`*` | MCP spec | Helm | Istio`†` |
 |--------------|--------------|------------|----------------|----------|------|----------|
+| 1.2.x | 14 May 2026 | 1.31 - 1.36 | 1.3 - 1.5`‡` | 2025-11-25 | >= 3.12 | 1.23 - 1.29 |
 | 1.1.x | 09 Apr 2026 | 1.31 - 1.35 | 1.3 - 1.5`‡` | 2025-06-18 | >= 3.12 | 1.23 - 1.29 |
 | 1.0.x | 16 Mar 2026 | 1.31 - 1.35 | 1.3 - 1.5`‡` | 2025-06-18 | >= 3.12 | 1.23 - 1.29 |
 | 2.2.x | 09 Feb 2026 | 1.31 - 1.35 | 1.2 - 1.4 | 2025-06-18 | >= 3.12 | 1.23 - 1.27 |

assets/agw-docs/pages/security/external-auth.md

@@ -304,11 +304,9 @@ You can apply a policy at two levels: the Gateway level or the HTTPRoute level.
    ...
    ```
 
-{{< version include-if="1.2.x" >}}
 ## Conditional execution
 
 To choose between multiple external authorization servers based on the request, use the `conditional` field on your `extAuth` policy. For example, you can send admin paths to a stricter authorization server and route every other request to a standard one. For details, see [Conditional policies]({{< link-hextra path="/about/policies/conditional-policies" >}}).
-{{< /version >}}
 
 ## Cleanup
 

assets/agw-docs/pages/security/rate-limit-global.md

@@ -875,11 +875,9 @@ Apply both local and global rate limits to the same traffic.
 
    The first 50 requests succeed (global limit), then subsequent requests return 429.
 
-{{< version include-if="1.2.x" >}}
 ## Conditional execution
 
 To apply different rate limits based on the request, use the `conditional` field on your `rateLimit` policy. For example, you can apply a strict per-IP limit to anonymous traffic and a higher per-user limit to authenticated traffic. For details, see [Conditional policies]({{< link-hextra path="/about/policies/conditional-policies" >}}).
-{{< /version >}}
 
 ## Cleanup
 

assets/agw-docs/pages/security/rate-limit-http.md

@@ -260,11 +260,9 @@ Local rate limiting runs independently on each proxy replica. If you run multipl
 
 For detailed instructions on setting up global rate limiting with descriptors and an external rate limit service, see the [Global rate limiting guide]({{< link-hextra path="/security/rate-limit-global" >}}).
 
-{{< version include-if="1.2.x" >}}
 ## Conditional execution
 
 To apply different rate limits based on the request, use the `conditional` field on your `rateLimit` policy. For example, you can apply stricter limits on writes than on reads. For details, see [Conditional policies]({{< link-hextra path="/about/policies/conditional-policies" >}}).
-{{< /version >}}
 
 ## Cleanup
 

assets/agw-docs/pages/traffic-management/direct-response.md

@@ -126,11 +126,9 @@ EOF
    Status: Healthy% 
    ```
 
-{{< version include-if="1.2.x" >}}
 ## Conditional execution
 
 To return a direct response only when a CEL expression matches, use the `conditional` field on your `directResponse` policy. For example, you can return `410 Gone` on deprecated paths and let every other request reach the backend. For details, see [Conditional policies]({{< link-hextra path="/about/policies/conditional-policies" >}}).
-{{< /version >}}
 
 ## Cleanup
 

assets/agw-docs/versions/n-patch.md

@@ -1 +1 @@
-{{< version include-if="1.1.x" >}}1.1.0{{< /version >}}{{< version include-if="1.2.x" >}}1.1.0{{< /version >}}
+{{< version include-if="1.1.x" >}}1.1.0{{< /version >}}{{< version include-if="1.2.x" >}}1.2.0{{< /version >}}{{< version include-if="1.3.x" >}}1.2.0{{< /version >}}

assets/agw-docs/versions/patch_n+1.md

@@ -1 +1 @@
-{{< version include-if="1.1.x" >}}1.1.0{{< /version >}}{{< version include-if="1.2.x" >}}1.1.0{{< /version >}}
+{{< version include-if="1.1.x" >}}1.2.0{{< /version >}}{{< version include-if="1.2.x" >}}1.2.0{{< /version >}}{{< version include-if="1.3.x" >}}1.2.0{{< /version >}}

assets/agw-docs/versions/patch_n-1.md

@@ -1 +1 @@
-1.0.1
+{{< version include-if="1.1.x" >}}1.0.1{{< /version >}}{{< version include-if="1.2.x" >}}1.1.0{{< /version >}}{{< version include-if="1.3.x" >}}1.2.0{{< /version >}}

assets/agw-docs/versions/short.md

@@ -1 +1 @@
-1.1
+{{< version include-if="1.1.x" >}}1.1{{< /version >}}{{< version include-if="1.2.x" >}}1.2{{< /version >}}{{< version include-if="1.3.x" >}}1.3{{< /version >}}