lots of documentation updates