refactor docs part 2