diff --git a/swh/loader/svn/converters.py b/swh/loader/svn/converters.py
--- a/swh/loader/svn/converters.py
+++ b/swh/loader/svn/converters.py
@@ -45,12 +45,12 @@
 ) -> Revision:
     """Given a svn revision, build a swh revision.
 
-    This adds an ['metadata']['extra-headers'] entry with the
+    This adds an 'extra-headers' entry with the
     repository's uuid and the svn revision.
 
     Args:
         - rev: the svn revision number
-        - commit: the commit metadata
+        - commit: the commit data: revision id, date, author, and message
         - repo_uuid: The repository's uuid
         - dir_id: the tree's hash identifier
         - parents: the revision's parents identifier
diff --git a/swh/loader/svn/loader.py b/swh/loader/svn/loader.py
--- a/swh/loader/svn/loader.py
+++ b/swh/loader/svn/loader.py
@@ -193,8 +193,8 @@
           svn revision number.
 
         Args:
-            rev (dict): the svn revision
-            commit (dict): the commit metadata
+            rev (int): the svn revision number
+            commit (dict): the commit data, with revision id, date, author, and message
             dir_id (bytes): the upper tree's hash identifier
             parents ([bytes]): the parents' identifiers