Welcome @MarekLabuz and thanks for the pull request!

@nodejs/documentation On the one hand, this will resolve the issue linked near the top. On the other hand, the whole requiring-bottom-references-that-are-unused-in-the-markdown file will be flagged by our lint rules as they currently stand and it's a bit non-intuitive.

At the moment, I'm feeling kind of -0 on it, maybe -0.5. I'd prefer something less obtrusive, more "just works". But I'm not sure we can realistically get there. I'm not concerned about broken links in the markdown-rendered docs. It would be nice if they weren't broken, but probably greater than 99% of our users read the HTML docs, not the rendered markdown in the GitHub interface or whatever.

I do appreciate the effort here and I'd like to see if there's a way to improve it a bit to something I'd be more +1 on.

Alright, I get it, thank you for your feedback. There is also a possibility to move these references to a separate file e.g.

{
  "synopsis": {
    "Command Line Options": "cli.html#cli_command_line_options",
    "web server": "http.html"
  }
}

However, I wonder whether it will be worth to maintain it since, as you said, the vast majority of users don't use it.

I think the problem here is pretty small and probably not worth any added complexity to our setup to solve, but others might feel differently. Anyone?

@nodejs/collaborators This could use some reviews.

CI: https://ci.nodejs.org/job/node-test-pull-request/26387/

needs a rebase I think https://ci.nodejs.org/job/node-test-commit/32422/console

I recall lots of "unified" errors in the without-ssl tests in earlier release lines, worth confirming that this passes that hurdle.

The rebase here seems to have gotten a bit confusing. I think I cleaned it up correctly, but please check.

Yes, I think it is correct, thank you.

CI: https://ci.nodejs.org/job/node-test-pull-request/26455/

withoutssl passed, that's all I cared about 👍

CI: https://ci.nodejs.org/job/node-test-pull-request/26461/

Landed in 62c61b7, thanks for the PR and sorry it took a while for somebody to get around to merging it!