some more doc enhancements