diff --git a/docs/specs/spec-meta-deposit.rst b/docs/specs/spec-meta-deposit.rst index 6226e783..d6726b99 100644 --- a/docs/specs/spec-meta-deposit.rst +++ b/docs/specs/spec-meta-deposit.rst @@ -1,103 +1,106 @@ The metadata-deposit ==================== Goal ---- 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 the metadata about an object in the archive. Requirements ------------ 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 +directories and content files, the metadata-deposit references any of the following: - origin - snapshot -- revision - release +- revision +- directory +- content A complete metadata example --------------------------- The reference element is included in the metadata xml atomEntry under the swh namespace: TODO: publish schema at https://www.softwareheritage.org/schema/2018/deposit .. code:: xml HAL hal@ccsd.cnrs.fr hal hal-01243573 The assignment problem https://hal.archives-ouvertes.fr/hal-01243573 other identifier, DOI, ARK Domain description author1 Inria UPMC author2 Inria UPMC 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: +It may also reference an object in the `SWH graph `: contents, +directories, revisions, releases, and snapshots: .. code:: xml Loading procedure ------------------ 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.