some small docblock updates