README: highlight code examples.
README: add note about dependency ordering and fix wording.
README: add compatibility section with build status badges.
README: add table of contents.
README: move onegov badge and table of contents.
Merge pull request #23 from 4teamwork/jone-readme-cleanup

Update readme