Skip to content

docs(adr): cite IANA and TLS RFCs for destination and identity ADRs - #224

Draft
seonghobae wants to merge 2 commits into
mainfrom
cursor/adr-iana-tls-rfc-citations-06ce
Draft

docs(adr): cite IANA and TLS RFCs for destination and identity ADRs#224
seonghobae wants to merge 2 commits into
mainfrom
cursor/adr-iana-tls-rfc-citations-06ce

Conversation

@seonghobae

@seonghobae seonghobae commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Draft only. Do not merge. Do not mark Ready.

Branched from current main, not stacked on open product PRs (including #219, #152, #208, #149, #209, #220, #37, #46, or any other open PR).

Docs only. No Rust, tests, Cargo, Dockerfile, or workflow changes. Accepted ADR 0004 and ADR 0006 decision text and Accepted status are unchanged. This adds APA 7th References with the live-checked DOI/URL locators those decisions already name.

What changed

  1. ADR 0004 now has an APA 7th References section citing RFC 6890, the two IANA special-purpose registries, and RFC 9110 only.
  2. ADR 0006 Standards is now References with the same existing decision prose plus APA locators for RFC 5280, RFC 9846, and RFC 9525 only. RFC 9846 remains the current TLS 1.3 authority (obsoletes RFC 8446). No OCSP/CRL claim.
  3. ADR index has a one-line note after the Accepted table that 0004/0006 now carry APA locators. The table itself is unchanged.
  4. CHANGELOG.md Unreleased/Changed has one short line.
  5. Customer README.md already pointed at docs/adr/; it was not rewritten.

Verified locators (live-checked 2026-08-25)

Source Locator Live-check
Cotton, M., Vegoda, L., Bonica, R. (Ed.), & Haberman, B. (2013). Special-purpose IP address registries (RFC 6890). RFC Editor. https://doi.org/10.17487/RFC6890 · https://www.rfc-editor.org/rfc/rfc6890 Crossref MATCH (M. Cotton, L. Vegoda, B. Haberman; editor R. Bonica; 2013-04). rfc-editor JSON authors ["M. Cotton", "L. Vegoda", "R. Bonica, Ed.", "B. Haberman"], HTTP 200.
Internet Assigned Numbers Authority. (n.d.). IANA IPv4 Special-Purpose Address Registry. Retrieved August 25, 2026, from https://www.iana.org/assignments/iana-ipv4-special-registry/iana-ipv4-special-registry.xhtml same URL HTTP 200 (canonicalizes to /iana-ipv4-special-registry).
Internet Assigned Numbers Authority. (n.d.). IANA IPv6 Special-Purpose Address Registry. Retrieved August 25, 2026, from https://www.iana.org/assignments/iana-ipv6-special-registry/iana-ipv6-special-registry.xhtml same URL HTTP 200 (canonicalizes to /iana-ipv6-special-registry).
Fielding, R. (Ed.), Nottingham, M. (Ed.), & Reschke, J. (Ed.). (2022). HTTP semantics (RFC 9110). RFC Editor. https://doi.org/10.17487/RFC9110 · https://www.rfc-editor.org/rfc/rfc9110 Crossref MATCH (editors R. Fielding, M. Nottingham, J. Reschke; 2022-06). rfc-editor JSON authors match, HTTP 200.
Cooper, D., Santesson, S., Farrell, S., Boeyen, S., Housley, R., & Polk, W. (2008). Internet X.509 public key infrastructure certificate and certificate revocation list (CRL) profile (RFC 5280). RFC Editor. https://doi.org/10.17487/RFC5280 · https://www.rfc-editor.org/rfc/rfc5280 rfc-editor JSON authors ["D. Cooper", "S. Santesson", "S. Farrell", "S. Boeyen", "R. Housley", "W. Polk"], May 2008, HTTP 200.
Rescorla, E. (2026). The Transport Layer Security (TLS) protocol version 1.3 (RFC 9846). RFC Editor. https://doi.org/10.17487/RFC9846 · https://www.rfc-editor.org/rfc/rfc9846 rfc-editor JSON authors ["E. Rescorla"], July 2026, HTTP 200.
Saint-Andre, P., & Salz, R. (2023). Service identity in TLS (RFC 9525). RFC Editor. https://doi.org/10.17487/RFC9525 · https://www.rfc-editor.org/rfc/rfc9525 rfc-editor JSON authors ["P. Saint-Andre", "R. Salz"], November 2023, HTTP 200.

Not cited: drafts, unmerged PRs, cancelled OpenCode/Strix scans, invented DNS-rebinding papers, RFC 8446 as current, rustls crate docs as standards.

Leave this pull request as GitHub Draft. Do not merge. Do not mark Ready.

Open in Web Open in Cursor 

Add APA 7th References with DOI and RFC Editor or IANA URL locators
to accepted ADR 0004 and ADR 0006. Decision text and Accepted status
are unchanged.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Aug 25, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Move the APA locator note below the Accepted table so rows 0008 and
0010 remain in the same table.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
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