Better docs added.

Can also be nuked once we hit the alpha milestone and solidify the initial db schema (along with collapsing all existing migrations).