more docblock edits