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
@@ -625,7 +625,7 @@
             ids (iterable): sha1 checksums
 
         Yields:
-            dictionaries with the following keys:
+            : dictionaries with the following keys:
 
                 - **id** (bytes)
                 - **metadata** (str): associated metadata
@@ -675,6 +675,7 @@
 
         Args:
             entries (dict): dictionaries with the following keys:
+
                 - **id** (bytes): revision identifier
                 - **indexer_configuration_id** (int): tool used to compute
                   metadata
@@ -747,6 +748,7 @@
 
         Args:
             entries (dict): dictionaries with the following keys:
+
                 - **id** (str): origin urls
                 - **indexer_configuration_id** (int): tool used to compute
                   metadata
diff --git a/swh/indexer/storage/db.py b/swh/indexer/storage/db.py
--- a/swh/indexer/storage/db.py
+++ b/swh/indexer/storage/db.py
@@ -94,7 +94,7 @@
         """Fetches entries from the `table` such that their `id` field
         (or whatever is given to `id_col`) is in `ids`.
         Returns the columns `cols`.
-        The `cur`sor is used to connect to the database.
+        The `cur` parameter is used to connect to the database.
         """
         cur = self._cursor(cur)
         keys = map(self._convert_key, cols)
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
@@ -651,6 +651,7 @@
 
         Args:
             entries (dict): dictionaries with the following keys:
+
                 - **id** (str): origin url
                 - **indexer_configuration_id** (int): tool used to compute
                   metadata