Skip to content

docs: clarify release lifecycle and link documentation to LibreSign ecosystem - #141

Merged
vitormattos merged 14 commits into
mainfrom
docs/version-navigation-and-archives
Nov 10, 2026
Merged

vitormattos merged 14 commits into
mainfrom
docs/version-navigation-and-archives

Conversation

@vitormattos

Copy link
Copy Markdown
Member

Objective

Make docs.libresign.coop easier to navigate using Nextcloud's documentation information architecture only as a reference. All changes are limited to LibreSign/documentation.

What changed

  • Put the upcoming development documentation (main, Nextcloud 36) at the top of the homepage and version selector, explicitly labelled not released.
  • Identify the current stable version (LibreSign 15 / Nextcloud 35) and the oldest documented stable version (LibreSign 13 / Nextcloud 33). Avoid claiming security support that has not been established in lifecycle.json.
  • Remove the vague Earlier stable release category for intermediate versions.
  • Add a collapsible older-release/EOL archive. Only link to EOL manuals that actually exist in the version catalog.
  • Document the archive limitation for LibreSign 12 / Nextcloud 32: stable12 documentation does not currently exist. Link to a historical documentation source snapshot with an explicit compatibility warning, rather than publishing newer manuals under a misleading historical label.
  • Add one shared, semantic ecosystem navigation for the homepage and Sphinx manuals, linking to the official LibreSign product, features, pricing, support, FAQ, community, contribution, app store, and LibreCode.
  • Add a commercial call-to-action to the existing LibreSign pricing/request-quote flow; do not duplicate commercial pages in this repository.
  • Adapt catalog sorting, partial publication, HTML verification, and unit tests. Preserve version-pinned OpenAPI, existing URLs, redirects, and PR preview base paths.

Validation

  • Signed + DCO commits: 96e3329, db76758.
  • Reviewed changes against current main (97e9b65), the publishing/preview workflows and existing automated tests.
  • CI and navigable PR preview are pending; do not treat this PR as validated until those checks pass and preview links have been reviewed.
  • No application code, Nextcloud documentation, GitHub issues, release branches, or production site deployment were modified.

Explicit follow-up (not presented as complete)

Restoring a full LibreSign 12 / Nextcloud 32 manual requires locating or curating a release-accurate historical source, validating its instructions against LibreSign 12, and publishing it as a separately reviewed stable12 documentation branch. The historical snapshot in this PR is not such a validated manual.

Review

Review the homepage (both viewport sizes and color modes), shared menu across stable and development manuals, version selector ordering, archived disclosure, external links, and isolated preview routing before merge.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@github-actions

github-actions Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1-4-g2a6da11

QR code for preview link

🚀 View preview at
https://libresign.github.io/site-preview/docs-preview/pr-141/

Built to branch gh-pages at 2026-11-10 22:50 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

Documentation: All versions · LibreSign 16 development manual · Review notes

Preview is separate from production. LibreSign 16 has not been released; the development manual describes the upcoming version.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@vitormattos
vitormattos marked this pull request as ready for review November 10, 2026 22:49
@vitormattos
vitormattos merged commit bc44721 into main Nov 10, 2026
4 checks passed
@vitormattos
vitormattos deleted the docs/version-navigation-and-archives branch November 10, 2026 22:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant