mixed documentation enhancements