doc: update dead anchors + other fixes

When reviewing the whole documentation I noticed quite a lot of outdated anchors/links, and other minor style fixes (mostly unordered lists) that could be nice to clean up.
I was going to include those fixes in #1798 but it was already a very big PR so I might as well make another one.