docs(ts): say why Library has no Symbol.dispose, as python.md already does - #26
Merged
Merged
Conversation
… does Issue #13 A6 asks whether the missing scope-based release on Library is a divergence to fix or a design to document. It is the latter, and bindings.md §Teardown already carries the full reasoning: a scope-based close on a Library is the mid-lifecycle teardown measured on 2026-08-31 to segfault on the next open, so Python and TypeScript both withhold it from Library alone, on purpose. python.md gained the one-line pointer in #23. ts.md is the other language with the same asymmetry and did not have it, so a reader of ts.md alone still met the surprise with no explanation. Now both say it. No code change: A6 needed confirming and documenting, not fixing. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018ckJDLjWhAAttQVrYnQEJD
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
1 participant
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.
Closes the documentation half of #13 A6. No code change — A6 asked for confirmation, not a fix.
A6 asks whether
Librarylacking a scope-based release is a divergence to fix or a design to document. It is the design, andbindings.md§Teardown (¶89, plus the measured reopen rule at ¶91) already carries the full reasoning:python.mdgained the one-line pointer in #23.ts.mdis the other language with the same asymmetry and had nothing, so a reader ofts.mdalone still hitusing librarynot working with no explanation nearby. Now both point at the same paragraph.Verified:
lint-prose,lint-paths,lint-public,markdownlint,dprint checkclean; parity 9/9.🤖 Generated with Claude Code
https://claude.ai/code/session_018ckJDLjWhAAttQVrYnQEJD