diff --git a/docs/tutorial.rst b/docs/tutorial.rst
--- a/docs/tutorial.rst
+++ b/docs/tutorial.rst
@@ -1,3 +1,5 @@
+:orphan:
+
 .. _lister-tutorial:
 
 Tutorial: list the content of your favorite forge in just a few steps
diff --git a/swh/lister/gitlab/lister.py b/swh/lister/gitlab/lister.py
--- a/swh/lister/gitlab/lister.py
+++ b/swh/lister/gitlab/lister.py
@@ -43,17 +43,17 @@
         transport_request identifier.
 
         For the gitlab lister, the 'credentials' entries is configured
-        per instance. For example:
-
-        - credentials:
-          - gitlab.com:
-            - username: user0
-              password: <pass>
-            - username: user1
-              password: <pass>
-            - ...
-          - other-gitlab-instance:
-            ...
+        per instance. For example::
+
+          - credentials:
+            - gitlab.com:
+              - username: user0
+                password: <pass>
+              - username: user1
+                password: <pass>
+              - ...
+            - other-gitlab-instance:
+              ...
 
         """
         params = {