diff --git a/docs/docs/00200-core-concepts/00100-databases/00300-spacetime-publish.md b/docs/docs/00200-core-concepts/00100-databases/00300-spacetime-publish.md
index dd805b69ecf..15d52f35936 100644
--- a/docs/docs/00200-core-concepts/00100-databases/00300-spacetime-publish.md
+++ b/docs/docs/00200-core-concepts/00100-databases/00300-spacetime-publish.md
@@ -106,7 +106,7 @@ For all available publishing options and flags, see the [`spacetime publish` CLI
 
 ### Environment Variables
 
-Modules can declare environment variables for configuration and secrets. Each publish supplies the complete set of values from the target's `env` configuration and declared shell variables. Required values must be supplied on every publish; omitted optional values are removed. The module and its environment update atomically.
+Modules can declare environment variables for configuration and secrets. Each publish supplies values from the target's `env` configuration and declared shell variables, then preserves unspecified stored values by default. Required values must exist in the resulting environment; optional values are removed only when you unset them explicitly or use `--replace-env`. The module and its environment update atomically.
 
 See [Environment Variables](./00700-environment-variables.md) for declarations, reading values in module code, publishing examples, and private tables for secrets that need to change without republishing.
 
diff --git a/docs/docs/00200-core-concepts/00600-clients/00700-typescript-reference.md b/docs/docs/00200-core-concepts/00600-clients/00700-typescript-reference.md
index 68d84fe951d..34100ce7e84 100644
--- a/docs/docs/00200-core-concepts/00600-clients/00700-typescript-reference.md
+++ b/docs/docs/00200-core-concepts/00600-clients/00700-typescript-reference.md
@@ -924,7 +924,7 @@ Each table or view defined by a module has an accessor method, whose name is the
 
 ```typescript
 class TableHandle {
-  public count(): number;
+  public count(): bigint;
 }
 ```