Don't repeat documentation, link to it instead

also fix some typos and improve some markdown formatting.