aboutsummaryrefslogtreecommitdiff
path: root/sources/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'sources/README.md')
-rw-r--r--sources/README.md15
1 files changed, 12 insertions, 3 deletions
diff --git a/sources/README.md b/sources/README.md
index b177c3d..f746d29 100644
--- a/sources/README.md
+++ b/sources/README.md
@@ -7,9 +7,18 @@ re-audited offline** if those sites change, move, or disappear — the project's
25-year-longevity aim. Reading references are facts, not creative works; this is
a provenance cache, not redistribution of anyone's edition.
-Refresh or extend with `sh scripts/snapshot-sources.sh [provider ...]`
-(idempotent: existing non-empty files are skipped). Every file is recorded in
-`manifest.tsv` (path, url, sha256, bytes). First archived **2026-07-29**.
+The data ships as a single compressed archive, **`sources/snapshot.tar.gz`**
+(~6 MB); `manifest.tsv` (path, url, sha256, bytes) and this README stay
+uncompressed for browsing. First archived **2026-07-29**.
+
+```sh
+# unpack the archived data (into git-ignored per-provider dirs):
+sh scripts/snapshot-sources.sh unpack # or: tar xzf sources/snapshot.tar.gz -C sources
+# refresh/extend from the live sites (idempotent — skips files already present):
+sh scripts/snapshot-sources.sh # all four providers
+# re-roll the archive after refreshing:
+sh scripts/snapshot-sources.sh pack # or: tar czf sources/snapshot.tar.gz -C sources <dirs>
+```
## What's here