diff --git a/docs/README.rst b/docs/README.rst
--- a/docs/README.rst
+++ b/docs/README.rst
@@ -1,5 +1,6 @@
-swh-py-template
-===============
+.. _swh-py-template:
 
-Python module template, used as skeleton to create new modules.
+Software Heritage - Python module template
+==========================================
 
+Python module template, used as skeleton to create new modules.
diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,10 +1,3 @@
-.. _swh-py-template:
-
-Software Heritage - Python module template
-==========================================
-
-Python module template, used as skeleton to create new modules.
-
 .. include:: README.rst
 
 .. toctree::
@@ -13,7 +6,7 @@
 
 
 Indices and tables
-==================
+------------------
 
 * :ref:`genindex`
 * :ref:`modindex`
diff --git a/setup.py b/setup.py
--- a/setup.py
+++ b/setup.py
@@ -43,7 +43,7 @@
     name="swh.<module-name>",  # example: swh.loader.pypi
     description="Software Heritage <Module's intent>",
     long_description=long_description,
-    long_description_content_type="text/markdown",
+    long_description_content_type="text/x-rst",
     python_requires=">=3.7",
     author="Software Heritage developers",
     author_email="swh-devel@inria.fr",