Open Issues Need Help
View All on GitHubAI Summary: In Node.js v25, the HTML anchors for documentation headings have had the `--` prefix removed. This change breaks existing links that still include the prefix, causing them to navigate to the correct page but not scroll to the intended section. The issue requires either fixing the anchor generation process or updating all affected links.
AI Summary: This issue proposes adding support for copying static assets (like images) in the web generator for Static Site Generation (SSG) in doc-kit. The solution involves introducing a `staticDir` option in the configuration file to recursively copy files from a specified directory into the generated output. This is necessary to ensure that projects using doc-kit can correctly include their static assets.
AI Summary: A regression has occurred where a link to the Node.js deprecations page is broken, and the tooling failed to detect this broken link. This issue requires fixing the broken link and potentially investigating why the old tooling was able to generate the expected anchor, suggesting a problem with the current documentation generation process.
AI Summary: This issue requests the restoration of anchor aliases in the documentation generator. This is necessary because external projects, like Express, still rely on these old anchor links, and they need time to update their references. The change is needed for both the legacy and new documentation generators.
AI Summary: The documentation for Node.js globals contains a broken link to the DOMException class. The anchor tag for DOMException incorrectly uses a double slash in the URL, leading to an invalid link. This issue is labeled as a 'good first issue', suggesting it's a straightforward fix.
AI Summary: The doc-kit tool currently flattens all generated files to the top-level output directory. This issue proposes modifying the tool to preserve the original directory structure of input files, creating corresponding subdirectories in the output. This change is a blocker for a related issue on the nodejs.org repository.
AI Summary: The user is reporting a discrepancy in how function signatures are displayed in the Table of Contents (TOC) between the preview and production documentation for `url.format`. Specifically, the preview TOC omits the parameter names, while the production TOC includes them, leading to confusion when multiple overloads exist.