updated docs according to the review