--- a/src/pyams_utils/interfaces/url.py	Sat Nov 23 01:24:11 2019 +0100
+++ b/src/pyams_utils/interfaces/url.py	Sat Nov 23 14:57:24 2019 +0100
@@ -10,11 +10,20 @@
 # FOR A PARTICULAR PURPOSE.
 #
 
-__docformat__ = 'restructuredtext'
+"""PyAMS_utils.interfaces.url module
+
+These interfaces are used to define different types of URLs which can be used in a web site.
+These includes absolute URLs, canonical URLs and related URLs.
+
+See :py:mod:`PyAMS URL module <pyams_utils.url>` for a longer description.
+"""
 
 from zope.interface import Interface
 
 
+__docformat__ = 'restructuredtext'
+
+
 class ICanonicalURL(Interface):
     """Interface used to get content's canonical URL"""