Add example of linking to the documentation
Fix bug triggered by first line of doc being of the form '----'