added functions documentation