Changeset View
Changeset View
Standalone View
Standalone View
docs/extrinsic-metadata-specification.rst
| Show All 23 Lines | |||||
| ^^^^^^^^^^^ | ^^^^^^^^^^^ | ||||
| Metadata authorities are entities that provide metadata about an | Metadata authorities are entities that provide metadata about an | ||||
| :term:`origin`. Metadata authorities include: code hosting places, | :term:`origin`. Metadata authorities include: code hosting places, | ||||
| :term:`deposit` submitters, and registries (eg. Wikidata). | :term:`deposit` submitters, and registries (eg. Wikidata). | ||||
| An authority is uniquely defined by these properties: | An authority is uniquely defined by these properties: | ||||
| * its type, representing the software/database from which metadata is | * its type, representing the kind of authority, which is one of these values: | ||||
| extracted (eg. `gitlab`, `wikidata`, `hal`). | * `deposit`, for metadata pushed to Software Heritage at the same time | ||||
| as a software artifact | |||||
| * `forge`, for metadata pulled from the same source as the one hosting | |||||
| the software artifacts (which includes package managers) | |||||
| * `registry`, for metadata pulled from a third-party | |||||
| * its URL, which unambiguously identifies an instance of the authority type. | * its URL, which unambiguously identifies an instance of the authority type. | ||||
| Examples: | Examples: | ||||
| =============== ================================= | =============== ================================= | ||||
| type url | type url | ||||
| =============== ================================= | =============== ================================= | ||||
| deposit https://hal.archives-ouvertes.fr/ | deposit https://hal.archives-ouvertes.fr/ | ||||
| deposit https://hal.inria.fr/ | deposit https://hal.inria.fr/ | ||||
| deposit https://software.intel.com/ | deposit https://software.intel.com/ | ||||
| gitlab https://gitlab.com/ | forge https://gitlab.com/ | ||||
| gitlab https://gitlab.inria.fr/ | forge https://gitlab.inria.fr/ | ||||
| gitlab https://0xacab.org/ | forge https://0xacab.org/ | ||||
| github https://github.com/ | forge https://github.com/ | ||||
| wikidata https://www.wikidata.org/ | registry https://www.wikidata.org/ | ||||
| swmath https://swmath.org/ | registry https://swmath.org/ | ||||
| ascl.net http://ascl.net/ | registry https://ascl.net/ | ||||
| =============== ================================= | =============== ================================= | ||||
| Metadata fetchers | Metadata fetchers | ||||
| ^^^^^^^^^^^^^^^^^ | ^^^^^^^^^^^^^^^^^ | ||||
| Metadata fetchers are software components used to fetch metadata from | Metadata fetchers are software components used to fetch metadata from | ||||
| a metadata authority, and ingest them into the Software Heritage archive. | a metadata authority, and ingest them into the Software Heritage archive. | ||||
| ▲ Show 20 Lines • Show All 119 Lines • Show Last 20 Lines | |||||