Doc updates/ tidying

Includes some of the updates from #107 and #91 - some are still outstanding, can do them here or on another branch (this one has the updated readme with `db-migrate` instead of `schema.sql` which may be causing confusion e.g. https://github.com/mozilla/openbadges-badgekit/issues/454).