Skip to main content
GoodFirstPicks
DashboardIssuesReposLeaderboard

GoodFirstPicks by Leaveitblank © 2026

CreatorRequest a RepoPrivacy PolicyTerms of Service
Some anchor links aren't working | GoodFirstPicks

Some anchor links aren't working

nodejs/node 0 comments 8d ago
View on GitHub
lowopenScope: clearSkill match: yesNode.jsJavaScript

Why this is a good first issue

Broken anchor links due to ID mismatch in documentation.

AI Summary

The issue involves fixing broken anchor links in the Node.js documentation where IDs are mismatched due to underscore removal during generation. The fix requires updating the links in the markdown files to match the generated IDs. No major blockers are apparent.

Issue Description

Affected URLS

  • https://nodejs.org/docs/latest/api/modules.html#__filename
  • https://nodejs.org/docs/latest/api/modules.html#__dirname

Problem

Those links refer to an HTML element with the ID __dirname or __filename instead of using the IDs without the underscores, because when the documentation content is generated, it appears to remove the underscores and generates IDs without underscores. You can find those links on this page: https://nodejs.org/docs/latest/api/globals.html#global-objects

The modules.md file also references __dirname and __filename several times, so this page also contains broken anchor links: https://nodejs.org/docs/latest/api/modules.html

Possible Cause

I think the problem is related to this: https://github.com/nodejs/doc-kit/blob/d9697c7fbbbddeca58f9dc71693d4af9774455e0/src/generators/metadata/constants.mjs#L12

I was thinking about changing the link in the files listed below, but I think that would break the link (at least in GitHub's Markdown editor), so that wouldn't be a good solution.

https://github.com/nodejs/node/blob/61102cdbb3d59155ad5bb4fc9419627a31e63f7a/doc/api/globals.md?plain=1#L14-L30

GitHub Labels

doc

Want to work on this?

Claim this issue to let others know you're working on it. You'll earn 10 points when you complete it!

Risk Flags

  • potential markdown rendering issues
Loading labels...

Details

Points10 pts
Difficultylow
Scopeclear
Skill Matchyes
Test Focusedno