Documentation Discussion

As a Newbie I had some problems to get the right informations and to figure out which functionality is built in and which is in work. Many times the information in the snip itself is outdated and one has to follow all the comments to figure out the current state. This is not what I expected under knowledge management.

Many macros (even image) are not documented right and one has to search for a snip using this macro to get an idea of the power of some macros.

I would suggest to take a namespace documentation and put all documentation snips there and have the documentation index page indexing all documentation relevant snips.

The documentation snips should be kept up-to-date. That means every time a comments/answers brings more light in the darkness, this should be followed up in the snip itself.

Some concepts are not clear or have been implemented different from the content in the snip. (i.e. the label concept, it was not possible to figure out the meaning of all the LabelTypes).

I hope this call for discussion will help to improve the quality of the documentation and easy up the life of the users and the developers. Maybe someone will start a documentation initiative?