doc: move dev setup instructions out of README

(actually removing them from README is a second commit
so that I can update README to point to readthedocs
before pushing it)

Signed-off-by: John Spray <john.spray@redhat.com>
doc: Fix some RST glitches

Signed-off-by: John Spray <john.spray@redhat.com>