many documentation enhancements