finish second round of documentation edits