[Docs] Broken references to sections

The documentaiton still contains references from the pandoc-style markup, which now land up verbatim in the rendered Sphinx docs.