Skip to content

docs(v5.6): dead release-asset download links and 26 stale external links #351

Open

Description

@zhang1939

What happened

docs.ivorysql.org serves the v5.6 branch, and an automated link check over that branch (every URL re-probed to rule out network false positives) found two clusters of dead links: release-asset URLs invalidated by an upstream rebuild, and stale external links — several of them the same ones already fixed on master.

1. Release assets replaced upstream (antora.yml)

antora.yml (EN+CN) pins the 5.6 package assets as IvorySQL-5.6-74c405c-20260918.*, but the release assets were replaced by a 74c405c-20261016 rebuild (verified via the release API). This kills every download link on the CPU architecture adaptation page in both languages (the page builds them from {package-link-*} attributes).

Additionally the 5.6 release ships no mips64el / loongarch64 packages at all (assets exist only for amd64/x86_64/arm64/aarch64), so those two table rows point at non-existent files.

2. Stale external links

# Page Dead link Cause Verified fix
1 4.6.2.adoc EN ×4 2× CrunchyData deep links (kustomize/monitoring, architecture high-availability.md#synchronous…), clone-cluster.md paths removed/renamed upstream → repo root / create-cluster.md
2 4.6.2.adoc CN ×2 github.com/IvonySQL/…, github.com/Ivory-operator/… misspelled GitHub orgs → github.com/IvorySQL/…
3 welcome.adoc / 4.4.adoc EN+CN www.ivorysql.org/…releases-page page removed from site → GitHub releases
4 3.2.adoc EN ×2 postgresql.org/docs/currenruntime-… URL typo → current/runtime-config-statistics.html
5 8.1.adoc CN ×2 CLA PDFs under /zh-CN/assets/files/… files removed → ivorysql.org/pdf/*.pdf (what master uses)
6 8.adoc EN www.ivorysql.org/zh-CN/docs/intro page removed → the ivorysql_docs repo the section describes

(The same fixes for items 1/3/4 were applied on master in #350; this issue is the v5.6 counterpart plus the asset updates, which only exist on v5.6.)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions