added documentation to the new functions