doc: README updates

This pull request fixes some capitalization and some RST syntax things, but the main thing is that we nail down a naming convention for jobs.