lots of documentation fixes