From 36f921b1638b954ce67a765b769bb1aea96d8e2f Mon Sep 17 00:00:00 2001
From: Stefano Zacchiroli <zack@upsilon.cc>
Date: Fri, 17 Apr 2020 16:23:13 +0200
Subject: [PATCH] identifiers.py: reference to SWHIDs using explicit anchors

---
 swh/model/identifiers.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/swh/model/identifiers.py b/swh/model/identifiers.py
index dd345134..4d25184b 100644
--- a/swh/model/identifiers.py
+++ b/swh/model/identifiers.py
@@ -743,11 +743,7 @@ class PersistentId(_PersistentId):
 
 
 def persistent_identifier(object_type, object_id, scheme_version=1, metadata={}):
-    """Compute persistent identifier (stable over time) as per
-       documentation.
-
-    Documentation:
-        https://docs.softwareheritage.org/devel/swh-model/persistent-identifiers.html  # noqa
+    """Compute :ref:`SWHID <persistent-identifiers>` persistent identifiers.
 
     Args:
         object_type (str): object's type, either 'content', 'directory',
@@ -776,7 +772,7 @@ def persistent_identifier(object_type, object_id, scheme_version=1, metadata={})
 
 
 def parse_persistent_identifier(persistent_id):
-    """Parse swh's :ref:`persistent-identifiers` scheme.
+    """Parse :ref:`SWHID <persistent-identifiers>` persistent identifiers.
 
     Args:
         persistent_id (str): A persistent identifier
-- 
GitLab