diff --git a/docs/package-loader-tutorial.rst b/docs/package-loader-tutorial.rst
--- a/docs/package-loader-tutorial.rst
+++ b/docs/package-loader-tutorial.rst
@@ -33,7 +33,7 @@
 ``swh-loader-core/swh/loader/package/pypi/``, and replace the names in those
 with your loader's.
 
-Finally, create an `entrypoint`_ in ``setup.py``, so your loader can be discovered
+Finally, create an `entrypoint`_ in :file:`setup.py`, so your loader can be discovered
 by the SWH Celery workers::
 
     entry_points="""
@@ -51,7 +51,7 @@
 It is now time for the interesting part: writing the code to load packages from
 a package manager into the |swh| archive.
 
-Create a file named ``loader.py`` in your package's directory, with two empty classes
+Create a file named :file:`loader.py` in your package's directory, with two empty classes
 (replace the names with what you think is relevant)::
 
    from typing import Optional
diff --git a/docs/vcs-loader-overview.rst b/docs/vcs-loader-overview.rst
--- a/docs/vcs-loader-overview.rst
+++ b/docs/vcs-loader-overview.rst
@@ -28,7 +28,7 @@
 but in its own directory (eg. ``swh-loader-git/swh/loader/git``, as ``swh.loader``
 is a :pep:`namespace package <420>`), based on the `swh-py-template`_ repository.
 
-It has at least one `entrypoint`_, declared in ``setup.py`` to be recognized
+It has at least one `entrypoint`_, declared in :file:`setup.py` to be recognized
 by ``swh-loader-core``::
 
     entry_points="""