refactor docs part 1