docs(release): switch the documentation to Fess 15.8.0 - #505
Merged
Conversation
Update release metadata for the Fess 15.8.0 release (Java 21, OpenSearch 3.8.0) consistently across all 7 languages (ja, en, de, es, fr, ko, zh-cn): - versions.json: 15.8 becomes the release and joins the supported list, with end of life on 2028-02-01 -- eighteen months after the release, which is the rule the neighbouring rows already follow - eol.rst: regenerated from versions.json by tools/update_eol.py, so 15.8.x is now the latest recommended version and 15.7.x is supported - documentation.rst: repoint the toctree 15.7 -> 15.8 - getting-started.rst, quick-start.rst: repoint :doc: links 15.7 -> 15.8 - downloads.rst: set the "latest stable" tip to 15.8.0 and add it as the first row of the stable list-table - index.rst: update the download link to 15.8.0; add the 15.8.0 news entry and keep the latest 5 entries - news.rst: prepend the 15.8.0 news entry - archives.rst: add the 15.7 archive section No supported version reached end of life since the last release, so nothing moves to the past-releases table this time.
The 15.8 tree was created by create_version.sh, which rewrites the Fess version and nothing else, so the installation pages still told readers to install OpenSearch 3.7.0. upgrade.rst was corrected separately and already said 3.8.0, so one documentation tree gave two different answers. Fess 15.8.0 builds against OpenSearch 3.8.0 -- opensearch.version in fess-parent 15.8.0 -- and every artifact these pages name exists at that version: the 3.8.0 bundle on artifacts.opensearch.org, the four org.codelibs.opensearch plugins on Maven Central, and the ghcr.io/codelibs/fess-opensearch:3.8.0 image. install.rst, install-linux.rst, install-windows.rst, prerequisites.rst, run.rst and uninstall.rst in all seven translations: 3.7.0 -> 3.8.0, in prose, download URLs, unpack directories, plugin coordinates and configuration paths.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Switch the documentation to the Fess 15.8.0 release (published 2026-08-20, Java 21, OpenSearch 3.8.0).
Release metadata
versions.jsonnow names 15.8 as the release and lists it as supported, with end of life on 2028-02-01 -- eighteen months after the release, the rule the neighbouring rows already follow.developmentstays at 15.8, which is what the Fess master branch is on (15.8.1-SNAPSHOT). The seveneol.rsttables were regenerated bytools/update_eol.py, so 15.8.x is the latest recommended version and 15.7.x moves to plain supported. No supported version reached end of life since the last release, so nothing moves to the past-releases tables this time.Landing pages, all seven languages
documentation.rst: toctree 15.7 -> 15.8getting-started.rst,quick-start.rst::doc:links 15.7 -> 15.8downloads.rst: "latest stable" tip set to 15.8.0, and 15.8.0 added as the first stable table rowindex.rst: download link to 15.8.0, 15.8.0 news entry added, latest five entries keptnews.rst: 15.8.0 entry prependedarchives.rst: 15.7 archive section addedOpenSearch version in the 15.8 installation pages
The 15.8 tree was created by
create_version.sh, which rewrites the Fess version and nothing else, soinstall.rst,install-linux.rst,install-windows.rst,prerequisites.rst,run.rstanduninstall.rststill told readers to install OpenSearch 3.7.0 whileupgrade.rst-- corrected separately -- already said 3.8.0. The second commit brings those six pages in every translation to 3.8.0 (364 occurrences: prose, download URLs, unpack directories, plugin coordinates, configuration paths).Fess 15.8.0 builds against OpenSearch 3.8.0 (
opensearch.versionin fess-parent 15.8.0), and each artifact these pages name was checked to exist at 3.8.0: the bundle on artifacts.opensearch.org, the fourorg.codelibs.opensearchplugins on Maven Central, and theghcr.io/codelibs/fess-opensearch:3.8.0image.Checks
python3 -m unittest discover -s tools -p 'test_*.py'-- 23 tests, OKpython3 tools/update_eol.py --check-- every translation matches versions.jsonpython3 tools/check_headings.py */15.8-- OK:doc:and toctree target introduced by this change resolves to a file that exists