Documentation fixes

A couple of minor documentation fixes as well as an overhaul of the core docs, removing anything that's incorrect/wrong/weak and improving/adding the odd bit here and there.

Fixes https://github.com/mysociety/popit/issues/223
Fixes https://github.com/mysociety/popit/issues/322