doc: fix links in synopsis.md

[srcmake]

I was looking at synopsis.md and noticed that the links in the file are broken. Basically, they point to .html files instead of .md files. This PR fixes it.

Testing:
In the node repository's synopsis.md:

1. Click the "Command Line Options" link. Notice it takes you to a 404 page.
2. Click the "web server" link. Notice it takes you to a 404 page.

In my branch's synopsis.md

1. Click the "Command Line Options" link. Notice it takes you to the correct page.
2. Click the "web server" link. Notice it takes you to the correct page.

Checklist

• make lint
• commit message follows commit guidelines

[Trott]

Thanks for the pull request. This will break the links on the website. The md files are inputs for generating html files on the website. It’s imperfect that the links don’t work in the source tree but it’s the better trade off.

If you want the links to be correct in both places, you’ll need to update the doc-generation script in the tools directory to intelligently update the links.

[srcmake]

Thanks for the pull request. This will break the links on the website. The md files are inputs for generating html files on the website. It’s imperfect that the links don’t work in the source tree but it’s the better trade off.

If you want the links to be correct in both places, you’ll need to update the doc-generation script in the tools directory to intelligently update the links.

Ohhhhh. I was wondering why they were .html after looking at your PR and was going to comment there, but I figured I'd just make the change myself...I didn't realize those files were used to generate the website. (Thanks for telling me, I always wondered where that website came from.)

In that case, I'm sure there are a lot of other links that point to .html files, and not just the ones in this file. So this PR isn't even that helpful

I think the correct steps forward is to create a new issue (to possibly make the generate.js tool smarter, citing this "viewing these files on github doesn't link nicely since the extensions are incorrect") for this and close this PR. Does that sound fine? If so, I can make the issue.

[Trott]

I think the correct steps forward is to create a new issue (to possibly make the generate.js tool smarter, citing this "viewing these files on github doesn't link nicely since the extensions are incorrect") for this and close this PR. Does that sound fine? If so, I can make the issue.

Works for me.

(Only the docs section of the website is generated from those md files. The rest of the website is in the https://github.com/nodejs/nodejs.org repository.)

[Fishrock123]

Unfortunately as Rich said, this needs to be kept for the website. Which is... more important that local links.

If we can build around this somehow that would be fine but should probably be done in a different PR.

[srcmake]

I made an Issue for this here: #28689

I'm closing this PR. Thanks for the advice Trott and Fishrock.