diff --git a/swh/lister/core/abstractattribute.py b/swh/lister/core/abstractattribute.py
index 17db1a8..3adabaf 100644
--- a/swh/lister/core/abstractattribute.py
+++ b/swh/lister/core/abstractattribute.py
@@ -6,11 +6,11 @@
 class AbstractAttribute:
     """AbstractAttributes in a base class must be overridden by the subclass.
 
-    It's like the :py:func:`abc.abstractmethod` decorator, but for things that
+    It's like the :func:`abc.abstractmethod` decorator, but for things that
     are explicitly attributes/properties, not methods, without the need for
     empty method def boilerplate. Like abc.abstractmethod, the class containing
-    AbstractAttributes must inherit from :py:class:`abc.ABC` or use the
-    :py:class:`abc.ABCMeta` metaclass.
+    AbstractAttributes must inherit from :class:`abc.ABC` or use the
+    :class:`abc.ABCMeta` metaclass.
 
     Usage example::
 
diff --git a/swh/lister/core/indexing_lister.py b/swh/lister/core/indexing_lister.py
index df8c31e..8166900 100644
--- a/swh/lister/core/indexing_lister.py
+++ b/swh/lister/core/indexing_lister.py
@@ -28,7 +28,7 @@ class SWHIndexingLister(SWHListerBase):
       necessary/available, some indication of the URL or index for fetching the
       next series of repository data.
 
-    See :py:class:`swh.lister.core.lister_base.SWHListerBase` for more details.
+    See :class:`swh.lister.core.lister_base.SWHListerBase` for more details.
 
     This class cannot be instantiated. To create a new Lister for a source
     code listing service that follows the model described above, you must
diff --git a/swh/lister/core/tasks.py b/swh/lister/core/tasks.py
index 8a3a7a0..5d4e0f6 100644
--- a/swh/lister/core/tasks.py
+++ b/swh/lister/core/tasks.py
@@ -28,7 +28,7 @@ class ListerTaskBase(Task, metaclass=AbstractTaskMeta):
         2. Refreshing the list of already discovered repositories.
 
         If the hosting service is indexable (according to the requirements of
-        :py:class:`SWHIndexingLister`), then we can optionally partition the
+        :class:`SWHIndexingLister`), then we can optionally partition the
         set of known repositories into sub-sets to distribute the work.
 
         This means that there is a third possible Task type for Indexing