Doc: fix broken links and syntax errors

This fixes broken links and some syntax errors.
I didn't change the links to old API documents because many of those are not yet documented in reST.