diff --git a/swh/storage/in_memory.py b/swh/storage/in_memory.py
--- a/swh/storage/in_memory.py
+++ b/swh/storage/in_memory.py
@@ -300,10 +300,10 @@
                 - type (one of 'git', 'tar'): type of the revision added
                 - directory (sha1_git): the directory the revision points at
                 - message (bytes): the message associated with the revision
-                - author_name (bytes): the name of the revision author
-                - author_email (bytes): the email of the revision author
-                - committer_name (bytes): the name of the revision committer
-                - committer_email (bytes): the email of the revision committer
+                - author (Dict[str, bytes]): dictionary with keys:
+                                             name, fullname, email
+                - committer (Dict[str, bytes]): dictionary with keys:
+                                                name, fullname, email
                 - metadata (jsonb): extra information as dictionary
                 - synthetic (bool): revision's nature (tarball, directory
                   creates synthetic revision)
@@ -392,8 +392,8 @@
                   represents a negative UTC offset
                 - name (bytes): the name of the release
                 - comment (bytes): the comment associated with the release
-                - author_name (bytes): the name of the release author
-                - author_email (bytes): the email of the release author
+                - author (Dict[str, bytes]): dictionary with keys:
+                                             name, fullname, email
 
         """
         for rel in releases:
diff --git a/swh/storage/storage.py b/swh/storage/storage.py
--- a/swh/storage/storage.py
+++ b/swh/storage/storage.py
@@ -542,10 +542,10 @@
                 - type (one of 'git', 'tar'): type of the revision added
                 - directory (sha1_git): the directory the revision points at
                 - message (bytes): the message associated with the revision
-                - author_name (bytes): the name of the revision author
-                - author_email (bytes): the email of the revision author
-                - committer_name (bytes): the name of the revision committer
-                - committer_email (bytes): the email of the revision committer
+                - author (Dict[str, bytes]): dictionary with keys:
+                                             name, fullname, email
+                - committer (Dict[str, bytes]): dictionary with keys:
+                                                name, fullname, email
                 - metadata (jsonb): extra information as dictionary
                 - synthetic (bool): revision's nature (tarball, directory
                   creates synthetic revision)
@@ -669,8 +669,8 @@
                   represents a negative UTC offset
                 - name (bytes): the name of the release
                 - comment (bytes): the comment associated with the release
-                - author_name (bytes): the name of the release author
-                - author_email (bytes): the email of the release author
+                - author (Dict[str, bytes]): dictionary with keys:
+                                             name, fullname, email
 
         """
         db = self.get_db()