Small clean up of the README.md

Added a section on limitations and additional info and cleaned up some
other sections to make them easier to read/understand.