This is good documentation, though I wonder if it'd be nicer/better to put some of this in the readme.md.