All pages and links seem to have this issue, it seems the script that changes the markdown refs to other man pages is broken. “Coincidentally”, it seems the docs site was just updated (edit: between 9 and 11 November). Another new issue: page titles don’t exist anymore. Possibly related:
However, the changes that can be seen on the site don’t seem to be reflected in any of the repositories…
Hi all, thanks so much for letting us know about these issues with the new docs site. We launched a rewrite of the docs site last Friday, and there are some issues parsing the markdown for the CLI docs. We’re tracking them internally, and we have got folks working on it. Thanks so much for your patience while we get these sorted out.
Page titles are being worked on and should be out soon (hopefully this week).
I agree with your other points – some navigation tweaks would make those docs easier to use. The sidebar wasn’t entirely compatible with the new structure of the non-CLI docs, but I think it’s worth exploring bringing it back for the CLI category. We’re gathering requirements for the second phase of the docs redesign project (phase 1 was largely about moving to a new static site generator and build process, and updating a large portion of the non-CLI content), so I’ll add your suggestions to our list. Thanks again!