From 1b6e9bcd613340a8b0aa916be8af530417253643 Mon Sep 17 00:00:00 2001
From: Gatefixer <313497061+lancedb-gatefixer[bot]@users.noreply.github.com>
Date: Thu, 22 Oct 2026 19:56:12 +0000
Subject: [PATCH] docs(python): clarify namespace fork reconstruction
 requirements

---
 python/python/lancedb/namespace.py | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/python/python/lancedb/namespace.py b/python/python/lancedb/namespace.py
index 9ff388d08..24253d214 100644
--- a/python/python/lancedb/namespace.py
+++ b/python/python/lancedb/namespace.py
@@ -486,10 +486,18 @@ class LanceNamespaceDBConnection(DBConnection):
             Default is None (no pushdown, all operations run locally).
         namespace_client_impl : Optional[str]
             The namespace implementation name used to create this connection.
-            Stored for serialization purposes.
+            Required together with namespace_client_properties for serialization
+            and reopening tables in forked worker processes.
         namespace_client_properties : Optional[Dict[str, str]]
             The namespace properties used to create this connection.
-            Stored for serialization purposes.
+            Required together with namespace_client_impl for serialization and
+            reopening tables in forked worker processes.
+
+        Notes
+        -----
+        If either reconstruction parameter is omitted, the namespace client is
+        opaque. Serializing the connection raises ValueError, and reopening an
+        inherited table in a forked worker raises RuntimeError explicitly.
         """
         self._namespace_client = namespace_client
         self.read_consistency_interval = read_consistency_interval