diff --git a/debian/control b/debian/control
index 3cf9cf2..68a9ef5 100644
--- a/debian/control
+++ b/debian/control
@@ -1,19 +1,19 @@
-Source: <dash-separated-module-name>
+Source: <dash-separated-module-name>  # example: swh-loader-pypi
 Maintainer: Software Heritage developers <swh-devel@inria.fr>
 Section: python
 Priority: optional
 Build-Depends: debhelper (>= 9),
                dh-python (>= 2),
                python3-all,
                python3-nose,
                python3-setuptools,
                python3-swh.core,
                python3-swh.storage,
                python3-vcversioner
 Standards-Version: 3.9.6
 Homepage: https://forge.softwareheritage.org/source/<phabricator short name>/
 
-Package: python3-<dot-separated-name-module>
+Package: python3-<dot-separated-name-module>  # example: python3-swh.loader.pypi
 Architecture: all
 Depends: ${misc:Depends}, ${python3:Depends}
 Description: Software Heritage <module-description>
diff --git a/debian/rules b/debian/rules
index a39db41..32f59e6 100755
--- a/debian/rules
+++ b/debian/rules
@@ -1,11 +1,11 @@
 #!/usr/bin/make -f
 
-export PYBUILD_NAME=<dot-separated-module-name>
+export PYBUILD_NAME=<dot-separated-module-name>  # example: swh.loader.pypi
 export PYBUILD_TEST_ARGS=--with-doctest -sva !db,!fs
 
 %:
 	dh $@ --with python3 --buildsystem=pybuild
 
 override_dh_install:
 	dh_install
 	rm -v $(CURDIR)/debian/python3-*/usr/lib/python*/dist-packages/swh/__init__.py
diff --git a/setup.py b/setup.py
old mode 100644
new mode 100755
index 2f587b7..d0acfe0
--- a/setup.py
+++ b/setup.py
@@ -1,30 +1,30 @@
 from setuptools import setup
 
 
 def parse_requirements():
     requirements = []
     for reqf in ('requirements.txt', 'requirements-swh.txt'):
         with open(reqf) as f:
             for line in f.readlines():
                 line = line.strip()
                 if not line or line.startswith('#'):
                     continue
                 requirements.append(line)
     return requirements
 
 
 # Edit this part to match your module
 # full sample: https://forge.softwareheritage.org/diffusion/DCORE/browse/master/setup.py
 setup(
-    name='swh.<module-name>',
+    name='swh.<module-name>',  # example: swh.loader.pypi
     description='Software Heritage <Module\'s intent>',
     author='Software Heritage developers',
     author_email='swh-devel@inria.fr',
     url='https://forge.softwareheritage.org/diffusion/<module-git-code>',
     packages=[],  # packages's modules
     scripts=[],   # scripts to package
     install_requires=parse_requirements(),
     setup_requires=['vcversioner'],
     vcversioner={},
     include_package_data=True,
 )