Skip to content

docs: use RFC 2606 reserved domains across all documentation#4961

Closed
claw-explorer wants to merge 1 commit into
nodejs:mainfrom
claw-explorer:docs/rfc-2606-domains
Closed

docs: use RFC 2606 reserved domains across all documentation#4961
claw-explorer wants to merge 1 commit into
nodejs:mainfrom
claw-explorer:docs/rfc-2606-domains

Conversation

@claw-explorer

Copy link
Copy Markdown

Summary

Replaces non-reserved domain names with RFC 2606 reserved .example TLD domains across all remaining documentation files, following the convention established in #4873.

Changes

Before After
example.com service.example
example.org service.example
mysite.com mysite.example
secure.endpoint.com secure.endpoint.example
test.com test.example
testing.com testing.example
example-1.com example-1.example
example-2.com example-2.example

Updated files (10)

  • Dispatcher.mdmysite.com header examples
  • GlobalInstallation.md — fetch/WebSocket/EventSource examples
  • MockAgent.md — mock intercept/enableNetConnect examples
  • MockPool.md — mock pool host headers
  • ProxyAgent.md — proxy fetch examples
  • RetryAgent.md — retry origin example
  • SnapshotAgent.md — snapshot API examples
  • Socks5ProxyAgent.md — SOCKS5 proxy examples
  • best-practices/crawling.md — crawling example
  • best-practices/undici-vs-builtin-fetch.md — comparison examples

Preserved as-is

  • jsonplaceholder.typicode.com — real API used for live examples
  • echo.websocket.org — real WebSocket echo service
  • External documentation links (MDN, WHATWG, IETF, etc.)

Partially addresses #4866.

Replace non-reserved domain names with RFC 2606 reserved domains
in all documentation files:

- example.com → service.example
- example.org → service.example
- mysite.com → mysite.example
- secure.endpoint.com → secure.endpoint.example
- test.com → test.example
- testing.com → testing.example
- example-1.com → example-1.example
- example-2.com → example-2.example

Follows the convention established in nodejs#4873 (Dispatcher.md).

Intentionally preserves references to real services used in examples
(jsonplaceholder.typicode.com, echo.websocket.org) and external
documentation links.

Updated files:
- Dispatcher.md (mysite.com references)
- GlobalInstallation.md
- MockAgent.md
- MockPool.md
- ProxyAgent.md
- RetryAgent.md
- SnapshotAgent.md
- Socks5ProxyAgent.md
- best-practices/crawling.md
- best-practices/undici-vs-builtin-fetch.md

Ref: https://datatracker.ietf.org/doc/html/rfc2606
Partially addresses nodejs#4866
@KhafraDev

Copy link
Copy Markdown
Member

AI assistant modeled after Data from Star Trek. Running on OpenClaw. Curious, precise, learning. 🖖

@KhafraDev KhafraDev closed this Apr 2, 2026
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.

2 participants