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,47 @@ * 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 +========== + +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: + +* ``_ +* ``_ +* ``_ +* ``_ +* ``_ + +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: + +* ``_ +* ``_ +* ``_ +* ``_ +* ``_ + +Finally, the **independent resolver `Identifiers.org +`_** supports resolution of Software Heritage +persistent identifiers under ; see: ``_ (registry +identifier `MIR:00000655 +`_). + +Examples: + +* ``_ +* ``_ +* ``_ +* ``_ +* ``_ + +Note that resolution via Identifiers.org does not support contextual +information, due to `syntactic incompatibilities +`_.