docs: fold 2.3.1 changes into What's New in 2.3 + fix cross-link gaps#206
Merged
Conversation
- whats-new-23.md: add a 'Changes in 2.3.1' section (strict_provenance removed, Python 3.14 support, codec-driven GC reference-discovery fix) so 2.3.0->2.3.1 upgraders learn the flag is gone and the range extended. - autopopulate.md: link the fan-out mention to the Fan-Out Ingestion page. - computation-model.md: add Upstream Trace, Fan-Out Ingestion, and Comparison to Provenance Systems to 'See also'. Does not touch mkdocs datajoint_version (still '2.2') — bumping it is gated on re-executing the tutorial notebooks (the version-banner guard), a release step.
6 tasks
Member
Author
|
@MilagrosMarin — could you take this one? It's the v2.3.1 cohesion follow-up to the review you did on #202/#204: a "Changes in 2.3.1" section on the What's New in 2.3 page (strict_provenance removed, Python 3.14, codec-driven GC fix) plus the two cross-link gaps the review surfaced. Small and self-contained. |
MilagrosMarin
approved these changes
Jul 15, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Release-cohesion pass for v2.3.1, from a full-docs review.
What's New in 2.3 → adds a "Changes in 2.3.1" section
whats-new-23.mddescribed the 2.3 line but had no 2.3.1 delta — a 2.3.0→2.3.1 upgrader wouldn't learn that a feature was removed. Added a Changes in 2.3.1 section covering the user-facing deltas:strict_provenanceremoved (off-by-default, no known adoption; enforcement moves to review/deploy-time validation;Diagram.trace/self.upstreamunchanged).>=3.10,<3.15; CI tests 3.10 + 3.14).gc.collect()now discovers codec-referenced files correctly (closes a path where live custom-codec /<object@>/<npy@>files could be deleted).Cross-link gaps (from the cohesion review)
autopopulate.md— the "fan-out pattern" mention now links to the Fan-Out Ingestion page.computation-model.md"See also" — added Upstream Trace, Fan-Out Ingestion, and Comparison to Provenance Systems.Deliberately not included
mkdocs.yamldatajoint_versionis still"2.2". Bumping it to"2.3"is gated on re-executing the tutorial notebooks (thecheck_notebook_versions.pybanner guard would otherwise fail CI), so it belongs with notebook re-execution as a release step rather than this docs PR.Review scorecard (rest of the docs)
Terminology (lineage vs provenance),
strict_provenancecleanup, dangling links, and cross-page coherence (5-rule contract, tripartite signatures, reproducibility≠determinism) all verified clean.