a bunch of documentation updates and reorganization