Rename `readme.adoc` to `README` since the latter is standardised. Also, rearrange sections, and add extra information.
