updated docs according to the reviews