Unified documentation layout

Removes hard line break in the root README.md and added another reference.
Imported changes with markup corrections