Index: /main/waeup.ikoba/trunk/src/waeup/ikoba/customers/documents.py
===================================================================
--- /main/waeup.ikoba/trunk/src/waeup/ikoba/customers/documents.py	(revision 12163)
+++ /main/waeup.ikoba/trunk/src/waeup/ikoba/customers/documents.py	(revision 12164)
@@ -67,4 +67,8 @@
     grok.baseclass()
 
+    # Ikoba can store any number of files per Document object.
+    # However, we highly recommend to associate and store
+    # only one file per Document object. Thus the following 
+    # tuple should contain only a single filename string.
     filenames = ()
 
@@ -113,4 +117,5 @@
         files = []
         try:
+            # Usually there is only a single element in self.filenames.
             for filename in self.filenames:
                 attrname = filename.replace('.','_')
@@ -124,5 +129,5 @@
 
     def setMD5(self):
-        """Set md5 checksum attribute for all files connected to this document.
+        """Set md5 checksum attribute for files connected to this document.
         """
         connected_files = self.connected_files
@@ -139,4 +144,8 @@
     """
 
+    # Ikoba can store any number of files per Document object.
+    # However, we highly recommend to associate and store
+    # only one file per Document object. Thus the following
+    # tuple should contain only a single filename string.
     filenames = ('sample',)
 
@@ -150,8 +159,14 @@
     grok.provides(ICustomerPDFDocument)
 
+    # Ikoba can store any number of files per Document object.
+    # However, we highly recommend to associate and store
+    # only one file per Document object. Thus the following
+    # tuple should contain only a single filename string.
+    filenames = ('sample.pdf',)
+
 CustomerPDFDocument = attrs_to_fields(CustomerPDFDocument)
 
 
-# Customer documents must be importable. So we might need a factory.
+# Customer documents must be importable. So we need a factory.
 class CustomerDocumentFactory(grok.GlobalUtility):
     """A factory for customer documents.
