diff --git a/docs/development/module.rst b/docs/development/module.rst
index 613c18f..816d8bf 100644
--- a/docs/development/module.rst
+++ b/docs/development/module.rst
@@ -40,7 +40,11 @@ This example will show “hello world” in the status bar:
 
 .. code:: python
 
-   """Short description"""
+   """Short description in RST format
+
+      please have a look at other modules, this will go into the
+      documentation verbatim (list of modules)
+   """
 
    import core.module
    import core.widget