We should update the GeoServer docs too.
see https://github.com/geotools/geotools/pull/3810 and https://github.com/geoserver/geoserver/pull/5715
We should update the GeoServer docs too.