Documentation improvements

Adds building instructions to `README.org` and cleans up formatting in the rest of the file.