Changeset View
Changeset View
Standalone View
Standalone View
docs/specs/spec-meta-deposit.rst
| The metadata-deposit | The metadata-deposit | ||||
| ==================== | ==================== | ||||
| Goal | Goal | ||||
| ---- | ---- | ||||
| A client wishes to deposit only metadata about an object in the Software | A client wishes to deposit only metadata about an object in the Software | ||||
| Heritage archive. | Heritage archive. | ||||
| The metadata-deposit is a special deposit where no content is | The metadata-deposit is a special deposit where no content is | ||||
| provided and the data transferred to Software Heritage is only | provided and the data transferred to Software Heritage is only | ||||
| the metadata about an object or several objects in the archive. | the metadata about an object or several objects in the archive. | ||||
| Requirements | Requirements | ||||
| ------------ | ------------ | ||||
| The scope of the meta-deposit is different than the | The scope of the meta-deposit is different than the | ||||
| sparse-deposit. While a sparse-deposit creates a revision with referenced | 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: | following: | ||||
| - origin | - origin | ||||
| - snapshot | - snapshot | ||||
| - revision | |||||
| - release | - release | ||||
| - revision | |||||
| - directory | |||||
| - content | |||||
| A complete metadata example | A complete metadata example | ||||
| --------------------------- | --------------------------- | ||||
| The reference element is included in the metadata xml atomEntry under the | The reference element is included in the metadata xml atomEntry under the | ||||
| swh namespace: | swh namespace: | ||||
| TODO: publish schema at https://www.softwareheritage.org/schema/2018/deposit | TODO: publish schema at https://www.softwareheritage.org/schema/2018/deposit | ||||
| ▲ Show 20 Lines • Show All 68 Lines • Show Last 20 Lines | |||||