docs: move some things around and reword on the index