add documentation for new functions