Documentation improvements

Adds building instructions to `README.org` and cleans up formatting in the rest of the file.  (If accepted, issue #251 should be closed.)