heavily updated documentation