From ccc6789cb5b19bef65a70468418580c34405ba20 Mon Sep 17 00:00:00 2001 From: rstoyanchev Date: Wed, 4 Mar 2026 15:21:02 +0000 Subject: [PATCH] Update docs for path API version resolver See gh-36398 --- .../modules/ROOT/pages/web/webflux-versioning.adoc | 7 +++---- .../modules/ROOT/pages/web/webmvc-versioning.adoc | 7 +++---- 2 files changed, 6 insertions(+), 8 deletions(-) diff --git a/framework-docs/modules/ROOT/pages/web/webflux-versioning.adoc b/framework-docs/modules/ROOT/pages/web/webflux-versioning.adoc index 070bc7798c7..50584235956 100644 --- a/framework-docs/modules/ROOT/pages/web/webflux-versioning.adoc +++ b/framework-docs/modules/ROOT/pages/web/webflux-versioning.adoc @@ -49,10 +49,9 @@ This strategy resolves the API version from a request. The WebFlux config provid options to resolve from a header, query parameter, media type parameter, or from the URL path. You can also use a custom `ApiVersionResolver`. -NOTE: The path resolver always resolves the version from the specified path segment, or -raises `InvalidApiVersionException` otherwise, and therefore it cannot yield to other -resolvers. - +The path resolver selects the version from a path segment specified by index, or +raises `InvalidApiVersionException`, and therefore never results in `null` (no version) +unless it is configured with a `Predicate` to determine if a path is versioned. diff --git a/framework-docs/modules/ROOT/pages/web/webmvc-versioning.adoc b/framework-docs/modules/ROOT/pages/web/webmvc-versioning.adoc index 6d548ad356b..fdde8cd4c01 100644 --- a/framework-docs/modules/ROOT/pages/web/webmvc-versioning.adoc +++ b/framework-docs/modules/ROOT/pages/web/webmvc-versioning.adoc @@ -49,10 +49,9 @@ This strategy resolves the API version from a request. The MVC config provides b options to resolve from a header, query parameter, media type parameter, or from the URL path. You can also use a custom `ApiVersionResolver`. -NOTE: The path resolver always resolves the version from the specified path segment, or -raises `InvalidApiVersionException` otherwise, and therefore it cannot yield to other -resolvers. - +The path resolver selects the version from a path segment specified by index, or +raises `InvalidApiVersionException`, and therefore never results in `null` (no version) +unless it is configured with a `Predicate` to determine if a path is versioned.