. some preliminary corrections to the documentation

Hey there

Updated the documentation where I thought it's necessary and added 2-3 TODO's. Will maybe jump in to write down some of the TODO's if that's a sensible thing to do before the next major release.