diff --git a/zscript-doc-2-api.md b/zscript-doc-2-api.md
index 2ef3300..38fc33c 100644
--- a/zscript-doc-2-api.md
+++ b/zscript-doc-2-api.md
@@ -1010,7 +1010,7 @@ class Object
 
 - `OnDestroy`
 
-   Called when the object is collected by the garbage collector. **Not deterministic.**
+   Called just before the object is collected by the garbage collector. **Not deterministic** unless the object is linked into the thinker list. Not all `Thinker`s are, so be careful when overriding this. Any `Actor` will generally be safe.
 
 ### Thinker