From: Eric Wong <e@80x24.org>
Date: Sat, 24 Apr 2021 09:28:44 +0000 (+0000)
Subject: doc: lei_design_notes: add a bit on WAL usage
X-Git-Tag: v1.7.0~756
X-Git-Url: http://www.git.stargrave.org/?a=commitdiff_plain;h=4492b8e066570fd841fff5528100e8197645c85e;p=public-inbox.git

doc: lei_design_notes: add a bit on WAL usage
---

diff --git a/Documentation/lei_design_notes.txt b/Documentation/lei_design_notes.txt
index a5606c05..f1d2ab6f 100644
--- a/Documentation/lei_design_notes.txt
+++ b/Documentation/lei_design_notes.txt
@@ -18,3 +18,15 @@ SQLite, and Xapian across multiple processes.
 The coupling of IMAP and NNTP network latency to local storage
 is a current weakness of public-inbox-watch.  Therefore, -watch
 will likely adopt the daemon architecture of lei in the future.
+
+Read/write vs read-only storage
+-------------------------------
+
+public-inboxes are intended to be written and read by different
+Unix users.  Commonly, a single Unix user or group will write to
+a public-inbox, but the inbox will be served by a user with
+read-only permissions (e.g. "www-data" or "nobody").
+
+lei/store is intended to be read and written by a single user,
+thus we can rely on the Write-Ahead-Log journal of SQLite to
+improve performance: <https://sqlite.org/wal.html>