diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e2fb791
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+swh-journal
+===========
+
+Persistent logger of changes to the archive, with publish-subscribe support.
+
+See the
+[documentation](https://docs.softwareheritage.org/devel/swh-journal/index.html#software-heritage-journal)
+for more details.