adding documentation for new functions