Docs

They needed updates. Fixes #32.
You should be listed first since you started the project and have done most of the work. @mythmon should probably also be listed. Maybe @lonnen and anyone else who helped, too.