diff --git a/swh/indexer/storage/__init__.py b/swh/indexer/storage/__init__.py
--- a/swh/indexer/storage/__init__.py
+++ b/swh/indexer/storage/__init__.py
@@ -450,7 +450,8 @@
             ids (iterable): sha1 checksums
 
         Yields:
-            `{id: facts}` where `facts` is a dict with the following keys:
+            dict: ``{id: facts}`` where ``facts`` is a dict with the
+            following keys:
 
                 - **licenses** ([str]): associated licenses for that content
                 - **tool** (dict): Tool used to compute the license
diff --git a/swh/indexer/storage/in_memory.py b/swh/indexer/storage/in_memory.py
--- a/swh/indexer/storage/in_memory.py
+++ b/swh/indexer/storage/in_memory.py
@@ -424,7 +424,8 @@
             ids (iterable): sha1 checksums
 
         Yields:
-            `{id: facts}` where `facts` is a dict with the following keys:
+            dict: ``{id: facts}`` where ``facts`` is a dict with the
+            following keys:
 
                 - **licenses** ([str]): associated licenses for that content
                 - **tool** (dict): Tool used to compute the license