docs: cleanup readme, update package description

Just keeping the docs a bit more inline with our styles and generally sane. :)