more doc enhancements