From 96e33293cf6d037675dedd82333805d26cd6f825 Mon Sep 17 00:00:00 2001 From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> Date: Tue, 10 Nov 2026 18:05:20 +0000 Subject: [PATCH 01/14] docs: show upcoming release first and identify historical documentation Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> --- _templates/home.html | 91 ++++++++++++++++++++---------- _templates/versions.html | 12 ++-- assets/version-switcher.js | 16 +++++- tests/js/version-switcher.test.mjs | 11 ++-- tests/test_versioning.py | 16 ++++-- versioning/build.py | 6 +- versioning/catalog.py | 2 +- versioning/publish.py | 2 +- versioning/verify.py | 4 +- 9 files changed, 105 insertions(+), 55 deletions(-) diff --git a/_templates/home.html b/_templates/home.html index 453e0e9d..cb938b53 100644 --- a/_templates/home.html +++ b/_templates/home.html @@ -3,7 +3,7 @@ - + LibreSign documentation · Versions and manuals @@ -26,9 +26,10 @@

Documentation by release

-

Find documentation for your version of LibreSign.

-

Choose the version installed on your Nextcloud server. Each manual - includes the API contract from that release, not from the development branch.

+

Find the LibreSign documentation for your version.

+

LibreSign adds document signing, signature requests, and validation to Nextcloud. + Choose the LibreSign release installed on your server: each manual and API + contract belongs to that release, not to the development branch.

Latest stable: LibreSign {{ current_stable }} {% for entry in versions if entry.slug == current_stable %} @@ -36,39 +37,26 @@

Find documentation for your version of LibreSign.

{% endfor %}

-
-

Find a task

-

Start with the latest stable LibreSign {{ current_stable }} manual, or choose your - installed version below.

- -
-

Available versions

-

Latest stable first. Development documentation is listed separately.

+

Upcoming and stable versions

+

Development first, followed by stable releases. Check the installed version before following a guide.

- {% for entry in versions %} -
+ {% for entry in versions if entry.status != 'eol' %} +
-

- {% if entry.slug == 'main' %}{% if entry.app_version is defined %}LibreSign {{ entry.app_version.split('.')[0] }}{% else %}Development{% endif %}{% else %}LibreSign {{ entry.slug }}{% endif %} -

-

- {% if entry.status == 'development' %}Development (not a stable release) - {% elif entry.status == 'eol' %}End of support - {% elif entry.status == 'current' %}Latest stable - {% else %}Earlier stable release{% endif %} -

+

{% if entry.slug == 'main' %}LibreSign · Upcoming{% else %}LibreSign {{ entry.slug }}{% endif %}

+ {% if entry.status == 'development' %} +

Upcoming release · documentation in development (not released)

+ {% elif entry.status == 'current' %} +

Latest stable release

+ {% elif entry.slug == oldest_stable %} +

Oldest documented stable release

+ {% endif %}

Nextcloud {{ entry.nextcloud_min }}{% if entry.nextcloud_min != entry.nextcloud_max %}–{{ entry.nextcloud_max }}{% endif %}

-
{% endfor %}
+
+ Older releases and end-of-life documentation +
+

Archived manuals are for historical reference only. Their availability does not + imply security updates or commercial support.

+ {% for entry in versions if entry.status == 'eol' %} +
+ {% endfor %} + {% if not (versions | selectattr('status', 'equalto', 'eol') | list) %} +

No verified end-of-life manuals are published in this catalog yet.

+ {% endif %} + {% if not (versions | selectattr('slug', 'equalto', '12') | list) %} +

LibreSign 12 was used with Nextcloud 32, but there is no verified + LibreSign 12 manual in this versioned site. A + historical documentation snapshot + exists; it has not been audited for compatibility with that release. + Do not substitute a newer manual for it.

+ {% endif %} +
+
+
+
+

Find a task

+

These shortcuts use the latest stable LibreSign {{ current_stable }} documentation. + Select your installed version above if you use an older release.

+

Release history is maintained in the application repository. - Archived documentation does not imply continued security maintenance or commercial support. + The oldest documented stable release is not necessarily the last release receiving security updates: + consult the release lifecycle for support information.