another big round of documentation edits