our package docs are too long yet to really need to be in their own file, but I'd like to flesh them out a bit more, particularly once #19 is resolved.