move some docs out of code