some docs on functions