Index: /main/waeup.ikoba/trunk/src/waeup/ikoba/documents/batching.py
===================================================================
--- /main/waeup.ikoba/trunk/src/waeup/ikoba/documents/batching.py	(revision 13145)
+++ /main/waeup.ikoba/trunk/src/waeup/ikoba/documents/batching.py	(revision 13146)
@@ -43,5 +43,13 @@
 
 class DocumentProcessorBase(BatchProcessor):
-    """A base for batch processors for IDocument objects.
+    """This is the base class for all kinds of document processors.
+    The `checkConversion` method checks whether `class_name` in a row
+    corresponds with the processor chosen. This is to avoid accidentally
+    wrong imports.
+
+    Document processors do not import workflow states or transitions which
+    means, all imported documents will be unpublished after batch creation.
+    In other words, publishing can't be done by import, it has do be done
+    via the UI.
     """
     grok.implements(IBatchProcessor)
Index: /main/waeup.ikoba/trunk/src/waeup/ikoba/documents/browser_templates/htmldocumentpage.pt
===================================================================
--- /main/waeup.ikoba/trunk/src/waeup/ikoba/documents/browser_templates/htmldocumentpage.pt	(revision 13145)
+++ /main/waeup.ikoba/trunk/src/waeup/ikoba/documents/browser_templates/htmldocumentpage.pt	(revision 13146)
@@ -35,7 +35,7 @@
       </td>
       <td>
-        &lt;a href=&quot;
-        <span tal:replace="python: view.url(context, 'display')"></span>
-        &quot;&gt;<span tal:replace="context/title">FILENAME</span>&lt;/a&gt;
+        &lt;a href=&quot;<span tal:replace="python: view.url(context, 'display')"></span>&quot;&gt;<span tal:replace="context/title">
+        FILENAME
+        </span>&lt;/a&gt;
       </td>
     </tr>
Index: /main/waeup.ikoba/trunk/src/waeup/ikoba/documents/export.py
===================================================================
--- /main/waeup.ikoba/trunk/src/waeup/ikoba/documents/export.py	(revision 13145)
+++ /main/waeup.ikoba/trunk/src/waeup/ikoba/documents/export.py	(revision 13146)
@@ -29,5 +29,11 @@
 
 class DocumentExporterBase(grok.GlobalUtility, ExporterBase):
-    """Exporter for documents.
+    """This is the exporter base class for all kinds of document exporters.
+    Derived classes export all documents of type `class_name` inside the
+    documents container.
+
+    All schema fields and the property attributes
+    `history`, `state`, `class_name` and `users_with_local_roles`
+    are being exported.
     """
     grok.implements(ICSVExporter)
@@ -54,5 +60,9 @@
 
     def mangle_value(self, value, name, context=None):
-        """Hook for mangling values in derived classes
+        """The mangler prepares the history messages and computes the
+        `users_with_local_roles` value which is a Python expression like:
+
+        ``[{'user_name': u'bob', 'local_role': u'bobsrole'},
+        {'user_name': u'anna', 'local_role': u'annasrole'}]``
         """
         if name == 'users_with_local_roles':
