Skip to content

docs(site): add NAT-types reference page#2

Merged
vnykmshr merged 2 commits intomainfrom
site-nat-types-reference
Apr 19, 2026
Merged

docs(site): add NAT-types reference page#2
vnykmshr merged 2 commits intomainfrom
site-nat-types-reference

Conversation

@vnykmshr
Copy link
Copy Markdown
Contributor

Adds site/nat-types.md (page at /nat-types/). Landing page gets the Homebrew install block now that the tap is live.

New standalone page at /nat-types/ that explains RFC 5780 mapping
behaviours, why APDM (symmetric NAT) breaks direct P2P, how CGNAT
is different, and when TURN is required. Written for developers
debugging their own apps; natcheck appears as the diagnostic CTA
near the bottom, not the subject.

Also adds the Homebrew install path to the landing page now that
the tap is live, and a "Background" link to the new reference.
Rewrite to minimum-sufficient dev register:

- Drop scene-setting opener and methodology preamble
- Remove meta-self-references ("this page is a reference", "the tool
  that motivates this page")
- Fix EIM × APDM row (was "usually works", really marginal — works
  only when APDM initiates)
- Clarify ICE behaviour: ICE cannot hole-punch APDM; it falls back
  to TURN (not "ICE does not fix it")
- Cut dramatic phrasings and moralizing closers
- Tighten matching sections on index.md

Same facts, ~30% shorter. Reads dev-to-dev.
@vnykmshr vnykmshr merged commit 25f02a3 into main Apr 19, 2026
5 checks passed
@vnykmshr vnykmshr deleted the site-nat-types-reference branch April 19, 2026 14:52
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.

1 participant