On Sep 18, 2013, at 3:03 PM, Torsten Bergmann <astares@gmx.de> wrote:

1. The community agreed on Spec to build UI's - so we should also agree on a common way
   for docu too. Otherwise more and more different solutions will come up (and the 
   situation will get worse). 

   We should agree on a common way where to package documentation: maybe on the 
   ConfigurationOfXXX class (Stef extends them with catalog informations, so why not also 
   with docu)

indeed.
Now I would prefer the pier syntax because 
- we have a working parser
- we can generate book from it with decent cross-referencing

stef