diff --git a/docs/internals.rst b/docs/internals.rst
index af951a8a2..786125d00 100644
--- a/docs/internals.rst
+++ b/docs/internals.rst
@@ -4,9 +4,8 @@
 Internals
 =========
 
-This page documents the internal data structures and storage
-mechanisms of |project_name|. It is partly based on `mailing list
-discussion about internals`_ and also on static code analysis.
+The internals chapter describes and analyses most of the inner workings
+of Borg.
 
 Borg uses a low-level, key-value store, the :ref:`repository`, and
 implements a more complex data structure on top of it, which is made
diff --git a/docs/internals/data-structures.rst b/docs/internals/data-structures.rst
index d0f1814bd..09886e4ac 100644
--- a/docs/internals/data-structures.rst
+++ b/docs/internals/data-structures.rst
@@ -6,6 +6,10 @@
 Data structures and file formats
 ================================
 
+This page documents the internal data structures and storage
+mechanisms of Borg. It is partly based on `mailing list
+discussion about internals`_ and also on static code analysis.
+
 .. todo:: Clarify terms, perhaps create a glossary.
           ID (client?) vs. key (repository?),
           chunks (blob of data in repo?) vs. object (blob of data in repo, referred to from another object?),