Skip to content

Commit 777619d

Browse files
docs(#1445): note at-most-once GC concurrency semantics
T3.1 deferral holding pattern for 2.3: document current behavior so quarantine-based serialization can land in 2.4 without retracting stronger claims.
1 parent 7ac4ecb commit 777619d

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

src/how-to/garbage-collection.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,14 @@ remain. This is by design:
1616

1717
Run garbage collection periodically to reclaim storage space.
1818

19+
!!! note "Concurrency semantics"
20+
Garbage collection is at-most-once: it scans references, then deletes
21+
unreferenced objects. An object inserted between the scan and the delete
22+
may be briefly orphaned. A future release will add quarantine-based
23+
serialization to close this window — until then, prefer running GC during
24+
quiet periods, and treat any single GC pass as best-effort rather than
25+
transactionally safe.
26+
1927
## Basic Usage
2028

2129
```python

0 commit comments

Comments
 (0)