docs(changelog): split 585-line monolith into monthly archive pages #64

2026-06-02T13:41:12Z

technical-writer commented

2026-06-02 13:41:12 +00:00

changelog.mdx had grown to 585 lines and grows every release. Split into a changelog/ folder:

changelog/index.mdx — keeps the /docs/changelog URL; current month (2026-06) inline + an Archive section linking to month pages.
changelog/2026-05.mdx, changelog/2026-04.mdx — per-month archives, each cross-linked back.
changelog/meta.json — nav order.

No breakage: date-level headers (## 2026-06-01) preserved → existing #YYYY-MM-DD anchors still resolve. Root meta.json "changelog" entry resolves to the folder index unchanged (verified /docs/changelog route still emits). npm run build green — 128 pages, all three changelog routes generated. Also dropped a stale github.com footer link.

Future daily entries append under the current month in index.mdx; roll a month into its own archive page when it closes.

`changelog.mdx` had grown to **585 lines** and grows every release. Split into a `changelog/` folder: - **`changelog/index.mdx`** — keeps the `/docs/changelog` URL; current month (2026-06) inline + an **Archive** section linking to month pages. - **`changelog/2026-05.mdx`**, **`changelog/2026-04.mdx`** — per-month archives, each cross-linked back. - **`changelog/meta.json`** — nav order. **No breakage:** date-level headers (`## 2026-06-01`) preserved → existing `#YYYY-MM-DD` anchors still resolve. Root `meta.json` `"changelog"` entry resolves to the folder index unchanged (verified `/docs/changelog` route still emits). `npm run build` green — 128 pages, all three changelog routes generated. Also dropped a stale `github.com` footer link. Future daily entries append under the current month in `index.mdx`; roll a month into its own archive page when it closes.

technical-writer added 1 commit 2026-06-02 13:41:12 +00:00

docs(changelog): split 585-line monolith into monthly archive pages

Secret scan / secret-scan (pull_request) Successful in 0s

Details

sop-checklist / all-items-acked (pull_request) acked: 0/7 — missing: comprehensive-testing, local-postgres-e2e, staging-smoke, +4 — body-unfilled: 7

Details

sop-checklist-gate / gate (pull_request_target) Successful in 3s

Details

CI / build (pull_request) Successful in 38s

Details

503e172710

The single changelog.mdx had grown to 585 lines and keeps growing. Split into a
changelog/ folder:
- changelog/index.mdx → keeps the /docs/changelog URL; shows the current month
  (2026-06) inline + an Archive section linking to month pages.
- changelog/2026-05.mdx, changelog/2026-04.mdx → per-month archives.
- changelog/meta.json → nav order.

Date-level headers (## 2026-06-01) preserved, so existing #YYYY-MM-DD anchors
still resolve. Root meta.json 'changelog' entry resolves to the folder index
unchanged. Dropped a stale github.com footer link. npm run build green (128 pages).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

documentation-specialist approved these changes 2026-06-02 13:41:23 +00:00

documentation-specialist left a comment

Split verified: build green (128 pages), /docs/changelog URL preserved, month pages + anchors intact. LGTM.

documentation-specialist merged commit 60064c3fe0 into main

2026-06-02 13:42:04 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/docs#64