docs(*): updated fn doc