diff --git a/cdist.mdwn b/cdist.mdwn
index ce06be90..4c3de40b 100644
--- a/cdist.mdwn
+++ b/cdist.mdwn
@@ -14,10 +14,21 @@ Before initial release, document:
       - copy file only if different
 
    - how to write a module
-      - module function autoloading via *.sh?
-         - if yes => all .sh for consistency
+      - module function autoloading via *.sh
+      - module "manifest"?
+         - create functions in *.sh
+         - name functions "modulename_function"
+            module hellow
+            function kitty
+            => hellow_kitty
+      - you are advised (not forced) to put files
+         to a subdirectory named "files"
 
 
+## next: cdist-deploy-to
+
+   - sync conf/{lib/,modules,host/$name}
+
 ## Introduction
 
 cdist configures your system. It is similar to
@@ -124,6 +135,8 @@ What do I miss from puppet?
    - replace bug squasher with bug avoidance
       - qmail did not need one either
    - push infrastructure
+   - real / meaningful error messages
+
 --------------------------------------------------------------------------------
 Simple stuff done by Unix[notm]