Skip to content

docs: fix remaining broken links in API documentation#5342

Open
AliMahmoudDev wants to merge 1 commit into
nodejs:mainfrom
AliMahmoudDev:fix/broken-doc-links
Open

docs: fix remaining broken links in API documentation#5342
AliMahmoudDev wants to merge 1 commit into
nodejs:mainfrom
AliMahmoudDev:fix/broken-doc-links

Conversation

@AliMahmoudDev
Copy link
Copy Markdown
Contributor

This relates to...

Fixes #3322

Changes

Bug Fixes

Several previous PRs (#3807, #3820, #5065) fixed many broken links in the Docsify-based documentation, but a number of relative links remained that resolve incorrectly on the live site at undici.nodejs.org.

The following broken links were fixed across 7 files:

File Broken Link Fixed Link
Pool.md [PoolStats](PoolStats.md) [PoolStats](/docs/docs/api/PoolStats.md)
RoundRobinPool.md [PoolStats](PoolStats.md) [PoolStats](/docs/docs/api/PoolStats.md)
MockCallHistory.md [see](./MockCallHistoryLog.md#to-string) [see](/docs/docs/api/MockCallHistoryLog.md#to-string)
SnapshotAgent.md [MockAgent](./MockAgent.md) [MockAgent](/docs/docs/api/MockAgent.md)
SnapshotAgent.md [MockCallHistory](./MockCallHistory.md) [MockCallHistory](/docs/docs/api/MockCallHistory.md)
SnapshotAgent.md [Testing](../best-practices/writing-tests.md) [Testing](/docs/docs/best-practices/writing-tests.md)
api-lifecycle.md 7x [Client.*](Client.md#...) [Client.*](/docs/docs/api/Client.md#...)
Dispatcher.md [Example 2](/docs/docs/api/Dispatch.md#...) [Example 2](/docs/docs/api/Dispatcher.md#...)
Fetch.md [install()](/docs/api/GlobalInstallation.md) [install()](/docs/docs/api/GlobalInstallation.md)

All links now use the consistent /docs/docs/api/ absolute path pattern established in the previously merged PRs.

Status

  • I have read and agree to the Developer Certificate of Origin 1.1
  • Documentation fix
  • Ready for review

Fixes nodejs#3322

Several previous PRs (nodejs#3807, nodejs#3820, nodejs#5065) fixed many broken links
in the Docsify-based documentation, but a number of relative links
remained that resolve incorrectly on the live site.

Changes:
- Pool.md: PoolStats.md -> /docs/docs/api/PoolStats.md
- RoundRobinPool.md: PoolStats.md -> /docs/docs/api/PoolStats.md
- MockCallHistory.md: ./MockCallHistoryLog.md#to-string -> /docs/docs/api/MockCallHistoryLog.md#to-string
- SnapshotAgent.md: 3 relative links -> absolute /docs/docs/api/ and /docs/docs/best-practices/ paths
- api-lifecycle.md: 7 Client.md relative links -> /docs/docs/api/Client.md
- Dispatcher.md: Dispatch.md -> /docs/docs/api/Dispatcher.md
- Fetch.md: /docs/api/ -> /docs/docs/api/

All links now use the consistent /docs/docs/api/ absolute path pattern
established in the previously merged PRs.

## Status
- [x] I agree to the Developer Certificate of Origin 1.1
- [x] Documentation fix
- [x] Ready for review
@metcoder95 metcoder95 requested a review from mcollina June 4, 2026 08:27
Copy link
Copy Markdown
Member

@mcollina mcollina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@codecov-commenter
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.23%. Comparing base (ce7df65) to head (b9cbb90).
⚠️ Report is 11 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #5342   +/-   ##
=======================================
  Coverage   93.22%   93.23%           
=======================================
  Files         110      110           
  Lines       36668    36668           
=======================================
+ Hits        34185    34188    +3     
+ Misses       2483     2480    -3     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Broken links in docs webpage

3 participants