final commit after documentation and simple revisions