updated docs for @viterp's changes