Major cleanup of class documentation (Part 1)