diff --git a/docs/specs/spec-meta-deposit.rst b/docs/specs/spec-meta-deposit.rst
--- a/docs/specs/spec-meta-deposit.rst
+++ b/docs/specs/spec-meta-deposit.rst
@@ -3,8 +3,8 @@
Goal
----
-A client wishes to deposit only metadata about an object in the Software
-Heritage archive.
+A client wishes to deposit only metadata about an origin or object in the
+Software Heritage archive.
The metadata-deposit is a special deposit where no content is
provided and the data transferred to Software Heritage is only
@@ -12,7 +12,7 @@
Requirements
------------
-The scope of the meta-deposit is different than the
+The scope of the metadata-deposit is different than the
sparse-deposit. While a sparse-deposit creates a revision with referenced
directories and content files, the metadata-deposit references one of the
following:
@@ -64,27 +64,32 @@
-Examples by target type
-^^^^^^^^^^^^^^^^^^^^^^^
-Reference an origin:
+References
+^^^^^^^^^^
+
+Origins
+=======
+
+The metadata may be on an origin, identified by the origin's URL:
.. code:: xml
-
+
+Graph objects
+=============
Reference a snapshot, revision or release:
.. code:: xml
- With ${type} in {snp (snapshot), rev (revision), rel (release) }:
-
+
@@ -93,7 +98,6 @@
Loading procedure
------------------
-In this case, the metadata-deposit will be injected as a metadata entry at the
-appropriate level (origin_metadata, revision_metadata, etc.) with the information
-about the contributor of the deposit. Contrary to the complete and sparse
-deposit, there will be no object creation.
+In this case, the metadata-deposit will be injected as a metadata entry of
+the relevant object, with the information about the contributor of the deposit.
+Contrary to the complete and sparse deposit, there will be no object creation.