cleanup real readme

Signed-off-by: Nico Schottelius <nico@kr.ethz.ch>

REAL_README

@@ -1,25 +1,30 @@
+[[!meta title="cdist - configuration management]]
+
 ## Introduction
 
-cdist configures your system. It is similar to
+cdist configures your system and is similar to
-[cfengine](http://www.cfengine.org/) and [puppet](http://www.puppetlabs.com/).
+other configuration management systems like
-It is inspired by both of those tools:
+[cfengine](http://www.cfengine.org/),
+[bcfg2](http://trac.mcs.anl.gov/projects/bcfg2),
+[chef](http://wiki.opscode.com/display/chef/)
+and [puppet](http://www.puppetlabs.com/), but
+it ticks differently:
 
- * Try to redo the great power you get
+ * cdist sticks completly to the KISS (keep it simple and stupid) paradigma
- * But leave out the bugs you also got
+  * cdist's core is very small (currently around 400 lines of code)
-
+  * There is only one type to extend cdist called ***type***.
-And cdist is UNIX:
+  * 
-
+ * cdist is UNIX
-It's designed to
+  * It reuses existing tools like cat, find, mv, ...
-reuse existing tools,
+  * cdist's documentation is bundled as manpages
-it does not require high level scripting language interpreters
+ * cdist is written in POSIX shell
-and it is equipped with manpages.
+  * No special requirements like high level interpreters needed on server or target
 
 ### Architecture
 
- * KISS (keep it simple and stupid)
+ * Push mode (server pushes configuration)
-  * Allow very easy extension of cdist (creating own types for instance)
+ * Pull mode (client triggers configuration)
- * Push (server pushes configuration) and Pull (client retrieves config) supported
+ * User defines configuration in shell scripts (called ***manifests***)
- * User defines configuration in shell scripts
  * Cdist generates internal configuration (cconfig style) and afterwards applies configuration
 
 ## Requirements