some doc enhancements