more documentation enhancements