Suggestion: Fixing a few broken links in the markdown version of the files and some light reorganization

Suggestion: Fixing a few broken links in the markdown version of the files and some light reorganization #2681