aboutsummaryrefslogtreecommitdiffstats
path: root/docs/lifecycle.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/lifecycle.md')
-rw-r--r--docs/lifecycle.md7
1 files changed, 6 insertions, 1 deletions
diff --git a/docs/lifecycle.md b/docs/lifecycle.md
index 829e425..e09ef01 100644
--- a/docs/lifecycle.md
+++ b/docs/lifecycle.md
@@ -91,7 +91,12 @@ document file holding a document is an error with no override.
rewritten after an epoch change, a restart, or when the appended part outgrew the
full save (at most every `--document-rewrite`, default 1h); a record cut short
by a crash is dropped when reading. A node starting from it is ready at once; sync
- merges what it missed, or it rejoins a newer epoch.
+ merges what it missed, or it rejoins a newer epoch. A node writes as a fresh actor
+ each start, unless `--keep-actor` and it stopped cleanly (the file marks a clean
+ stop, and the mark is undone as the node starts on it): then it writes on as the actor
+ of before, as nothing it wrote is missing. Fewer actors mean fewer signatures in every
+ transfer of the epoch's history (a writer each); a crash, a drop, or a switch or a
+ rejoin still starts a fresh one.
* **A backup** (`GET /admin/document`) is the whole document with its history, naming
its swarm and epoch. `--recover-from` starts a node on it; `--genesis --remake
import:FILE` starts a *new* swarm with its content; an `import` remake brings its