doc revisions (final?)