starting to move some of the documentation out of the readme