Lots of improvements to the user manual
Cross link and but the docs more prominent in the readme