Skip to content

Commit 9e8abca

Browse files
authored
docs: explain versioning guarantees and format evolution (#9947)
## Summary Explains backward compatibility and how newer writers can target older readers, with separate practical guidance and design documentation. Distinguishes current guarantees from planned compressor behavior. ## Changes Adds an older-reader example, Rust configuration, a writer-to-reader diagram, a full compatibility matrix with explanatory footnotes, and an edition registry. The proof remains in draft #9950. Validation was limited to source inspection. --------- Signed-off-by: "Connor Tsui" <[email protected]> Signed-off-by: Connor Tsui <[email protected]>
1 parent 2c8c7ee commit 9e8abca

17 files changed

Lines changed: 1060 additions & 424 deletions

File tree

‎docs/_static/versioning-checks.svg‎

Lines changed: 70 additions & 0 deletions
Loading
Lines changed: 127 additions & 0 deletions
Loading

‎docs/_static/versioning-flow.svg‎

Lines changed: 72 additions & 0 deletions
Loading

‎docs/_theme/vortex/vortex.css‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,10 @@ table.docutils th, table.docutils td {
252252
}
253253
table.docutils th { background: var(--bg-alt); }
254254

255+
table.versioning-terms p { margin: 0; }
256+
table.versioning-terms td:first-child { white-space: nowrap; }
257+
figure.versioning-diagram { margin-inline: 0; }
258+
255259
.page-index .content > section > h1 {
256260
position: absolute;
257261
width: 1px; height: 1px;

0 commit comments

Comments
 (0)