This is an automated email from the ASF dual-hosted git repository. rnewson pushed a commit to branch lucene_version_handling_docs in repository https://gitbox.apache.org/repos/asf/couchdb.git
commit f68c096bab21c3d226f4acba1a1efcec3e19587c Author: Robert Newson <[email protected]> AuthorDate: Mon Jun 29 14:15:47 2026 +0100 clarify lucene_version handling closes: https://github.com/apache/couchdb/issues/6054 --- src/docs/src/ddocs/nouveau.rst | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/src/docs/src/ddocs/nouveau.rst b/src/docs/src/ddocs/nouveau.rst index d7626cfc5..7cbaec661 100644 --- a/src/docs/src/ddocs/nouveau.rst +++ b/src/docs/src/ddocs/nouveau.rst @@ -72,9 +72,18 @@ Nouveau has been upgraded to use Lucene 10, earlier releases used Lucene 9. Nouveau can query and update indexes created by Lucene 9 but will not create new ones. The index definition can optionally define a ``lucene_version`` field -(which must be either 9 or 10 expressed as an integer). If not specified -when defining a new index the current version (10) will be automatically -added to the definition. +(which must be either 9 or 10 expressed as an integer). + +If not specified when defining a new index the current version (10) +will be automatically added to the definition. + +Updates to existing design documents do not get a version number +inserted automatically so as not to invalidate working Lucene 9 +indexes. + +It is recommended to add an explicit ``lucene_version`` field when +creating or modifying index definitions, setting it to the highest +value your installation supports. As Lucene only supports indexes up to one major release behind the current, it is important to rebuild all indexes to the current release. As Lucene major
