documentation reworked

more correction of documentation