documentation updates and fixes