1 files changed, 3 insertions, 1 deletions

diff --git a/docs/storage.md b/docs/storage.md
index e533589..e4a66d2 100644
--- a/docs/storage.md
+++ b/docs/storage.md
@@ -43,7 +43,9 @@ level schema migration is intentionally introduced.
 `wallet.dat` is accessed through `CWalletDB`.
 Read-only tooling should go through `ScanWalletRecords()` instead of opening a
 Berkeley DB cursor directly. That keeps migration checks, audits, and future
-backends behind one record-stream boundary.
+backends behind one record-stream boundary. Wallet rewrite code should also use
+that boundary when it needs to copy existing records into a newly written
+wallet file.
 
 | Key shape | Value | Secret? | Meaning |
 |---|---|---:|---|