diff --git a/docs/persistent-identifiers.rst b/docs/persistent-identifiers.rst --- a/docs/persistent-identifiers.rst +++ b/docs/persistent-identifiers.rst @@ -128,23 +128,6 @@ of the entire Darktable Git repository taken on 4 May 2017 from GitHub -Resolution ----------- - -Persistent identifiers can be resolved using the Software Heritage Web -application (see :py:mod:`swh.web`). - -In particular, the root endpoint ``/`` can be given a persistent identifier and -will lead to the browsing page of the corresponding object, like this: -``https://archive.softwareheritage.org/``. For example: - -* ``_ -* ``_ -* ``_ -* ``_ -* ``_ - - Contextual information ====================== @@ -191,3 +174,54 @@ * software origin: where a given object has been found or observed in the wild, as the URI that was used by Software Heritage to ingest the object into the archive + + +Resolution +========== + + +Dedicated resolvers +------------------- + +Persistent identifiers can be resolved using the Software Heritage Web +application (see :py:mod:`swh.web`). In particular, the **root endpoint** +``/`` can be given a persistent identifier and will lead to the browsing page +of the corresponding object, like this: +``https://archive.softwareheritage.org/``. + +A **dedicated ``/resolve`` endpoint** of the HTTP API is also available to +explicitly request persistent identifier resolution; see: +:http:get:`/api/1/resolve/(swh_id)/`. + +Examples: + +* ``_ +* ``_ +* ``_ +* ``_ +* ``_ + + +External resolvers +------------------ + +The following **independent resolvers** support resolution of Software +Heritage persistent identifiers: + +* `Identifiers.org `_; see: + ``_ (registry identifier `MIR:00000655 + `_). + +* `Name-to-Thing (N2T) `_ + +Examples: + +* ``_ +* ``_ +* ``_ +* ``_ +* ``_ + +Note that resolution via Identifiers.org does not support contextual +information, due to `syntactic incompatibilities +`_.