lots of updated documentation