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.