adding more entries to the docs and fix small doc-bugs