--- a/src/pyams_viewlet/metadirectives.py	Fri Jan 18 15:32:56 2019 +0100
+++ b/src/pyams_viewlet/metadirectives.py	Wed Nov 27 15:57:21 2019 +0100
@@ -10,19 +10,20 @@
 # FOR A PARTICULAR PURPOSE.
 #
 
-__docformat__ = 'restructuredtext'
-
-
-# import standard library
+"""PyAMS_viewlet.metadirectives module
 
-# import interfaces
-from pyams_viewlet.interfaces import IViewletManager
+This template provides definition of ZCML directives.
+"""
 
-# import packages
 from zope.configuration.fields import GlobalInterface, GlobalObject
 from zope.interface import Interface
 from zope.schema import TextLine
 
+from pyams_viewlet.interfaces import IViewletManager
+
+
+__docformat__ = 'restructuredtext'
+
 
 class IContentProvider(Interface):
     """A directive to register a simple content provider.
@@ -59,9 +60,12 @@
                           required=False)
 
     layer = GlobalInterface(title="The layer the view is in",
-                            description="""A skin is composed of layers. It is common to put skin
-                                        specific views in a layer named after the skin. If the 'layer'
-                                        attribute is not supplied, it defaults to 'default'.""",
+                            description="A skin is composed of layers; layers are defined as "
+                                        "interfaces, which are provided to the request when the "
+                                        "skin is applied. It is common to put skin "
+                                        "specific views in a layer named after the skin. If the "
+                                        "'layer' attribute is not supplied, it defaults to "
+                                        "IRequest, which is the base interface of any request.",
                             required=False)
 
 
@@ -101,4 +105,5 @@
 
 
 # Arbitrary keys and values are allowed to be passed to the viewlet.
+# pylint: disable=no-value-for-parameter
 IViewletDirective.setTaggedValue('keyword_arguments', True)