adding more clear documentation

Like suggested in http://code.opencv.org/issues/3933
This is an attempt into making this work out and providing a fine structure for future releases