Skip to content

docs(source): v1.0.0 release hygiene — changelogs, STABILITY flip, honest stability docs - #204

Merged
joshua-temple merged 1 commit into
mainfrom
docs/source-v1-stability
Aug 23, 2026
Merged

docs(source): v1.0.0 release hygiene — changelogs, STABILITY flip, honest stability docs#204
joshua-temple merged 1 commit into
mainfrom
docs/source-v1-stability

Conversation

@joshua-temple

Copy link
Copy Markdown
Collaborator

Checkpoint 4/5 — release hygiene on the road to source/v1.0.0

  • source/CHANGELOG.md (new): frozen-contract record + this cycle's changes, matching the repo's Keep-a-Changelog per-module style.
  • source/kafka/CHANGELOG.md: [Unreleased][1.0.0] with the frozen ack model and every behavior change from checkpoints 1–3 (Nak re-seek, drain-after-Close, cold-group seek/lag, tx-Term rejection, dep isolation).
  • Root CHANGELOG.md: source moves under Stable with links to both changelogs.
  • STABILITY.md: source → stable (v1.x) label; graduation note referencing issue Stabilize the experimental tier toward v1 + publish a compatibility matrix #179; experimental row now lists only sink among IO edges.
  • README.md: modules table sourcev1.0.0 (stable).
  • kafka README/package doc: Stability sections updated; new Setup notes document the DLQ-topic-must-pre-exist constraint and the MSK/IAM auth path (franz-go mechanism constructors imported directly, as intended).

Evidence: markdown-only except two doc-comment blocks in kafka.go; full CI matrix runs on this PR.

…nest stability docs

F: source/CHANGELOG.md written (Keep-a-Changelog style matching sibling
modules) recording the frozen contract and this cycle's behavior changes;
source/kafka/CHANGELOG.md's Unreleased becomes the 1.0.0 entry with the frozen
ack model, the Nak re-seek change, the drain fix, the cold-group seek/lag fix,
and the integration-dep removal; the root CHANGELOG index moves source under
Stable with links to both changelogs; STABILITY.md moves source to the stable
label, documents the graduation against issue #179, and README's modules
table flips source to v1.0.0 (stable); kafka README/package doc Stability
sections updated and MSK/IAM auth plus DLQ-topic-must-exist setup notes added.
@joshua-temple
joshua-temple merged commit 2931f24 into main Aug 23, 2026
121 checks passed
@joshua-temple
joshua-temple deleted the docs/source-v1-stability branch August 23, 2026 04:00
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