Publish curated Ludarium source from e15d06f97e5204dd853ef3d25e326d8c6d49936f

README.md

@@ -89,6 +89,12 @@ flowchart LR
 
 The cataloging pipeline only reads mounted source libraries. PostgreSQL stores identities, provenance, collections and review state; cache, exports and optional player data use separate writable locations. This separation lets you re-scan or restore the catalog without changing original game files.
 
+## When an archive appears empty
+
+Check the container's read-only library mounts and file permissions, then inspect scan progress and the reported format confidence. A mounted directory can be accessible without containing a recognized game format. Review uncertain candidates before correcting metadata or resolving duplicate groups.
+
+Preserve manual decisions and application state during upgrades. Keep a backup of the catalog in addition to the original archive: rescanning source files does not recreate your notes, collections and review decisions. Exporting a launcher catalog does not grant rights to redistribute its games or binaries.
+
 ## Development
 
 The backend targets .NET 10, the UI uses React 19 and Vite, and controller helpers use Python's standard