improve functions documentation