You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
docs: align stability and support messaging with what the project actually does #397
The docs make promises that the current plan and history do not match:
PHILOSOPHY.md §7: "Once v1.0 ships, file format is stable for decades." Line 410: "Once v1.0 ships, format is frozen for decades." But v1.0 shipped on 2026-05-02, and v3.0.0 moves to format v8 and drops v1–v6 read support.
PHILOSOPHY.md line 46: "12-15 months to production". ROADMAP.md line 3: "production-ready". These disagree with each other and with the open data-integrity issues.
.github/SECURITY.md lists only "latest 1.x minor line" as supported. The current line is 2.x.
The project released three major versions (v1, v2, v3 planned) within about 5 months, but no written policy says how long a major version gets fixes.
Ask
Rewrite the stability section as a policy, not a promise:
what counts as a format change;
how long each format version stays readable after it is superseded (for example: v(N+1) always reads v(N); drop v(N−1) only in the next major);
the migration guarantee.
Add a support policy: which major and minor lines get security and data-integrity fixes, and for how long after the next major ships. For example, "v2.x gets data-integrity fixes for 12 months after v3.0.0".
Fix the SECURITY.md version table.
Replace "production-ready" and "never losing data" with claims that are accurate today. Link to the tracker issue and the durability guide.
Update the wiki pages that repeat these claims (Comparison.md, Use-Cases.md).
Activity
docs(roadmap): make v2.0.2 the final v2.x release, split v3.0.0/v3.1.0 (
docs: fix unsafe WAL recovery advice and align docs with milestones (#…
release: v2.0.2 — final planned v2.x release