Yadis

Identity, trust and the plumbing of the web·on the home of the Yadis discovery protocol since 2005

§02  Web Standards

How to Read an RFC in Minutes

How to Read an RFC in Minutes

07-03-2015 - Abaixo Assinado na Faculdade Uniesp (10) / Vereadora Mida, CC BY 2.0

Before diving into the text of an RFC, always check its status, updates, publication stream, and errata. The RFC Editor says these metadata inputs are crucial to determining an RFC's current relevance and reliability.

RFC Status First

The metadata preceding each RFC includes its current status, publication stream, updates, and errata. These are essential for deciding whether the document is still the one to rely on.

RFCs can become obsolete or be updated by later RFCs, or have errata filed against them. A key step is verifying the metadata for each of these items. Only an RFC marked as “Current” can be trusted as definitive for its subject area, as a working standard, or as disused as a historical record.

Read the Normative Language Carefully

RFC 8174 specifies that RFC 2119's keywords—MUST, SHOULD, and MAY—only carry their special meaning when typed in uppercase. At minimum, you should scan the document carefully for these words to spot the requirements, strong recommendations, and purely optional parts.

Different words, even if similar, need careful evaluation. For instance a lowercase “must” or “may” does not carry the same normative weight as the exact, all-caps keywords from RFC 2119.

Follow the References

Beyond just the text currently in the document, it's necessary to follow cross-references inside as well as citations of other documentation. The IETF guidance teaches that just the sections directly on your topic are often not exhaustive. In-depth understanding usually means also reading over the referenced parts, especially if they fall in separate RFCs.

Other helpful text in an RFC—a Terminology appendix, Security Considerations segment, or "Status of This Memo" section—should also be measured and understood for framing the actual specification text.

An RFC is usually accompanied by a series of related RFCs, drafts and mailing list discussions—by following those references, you can grasp the contextual meaning of the key RFC much quicker and more authoritatively.

Finding the Caveats

While the main protocol explanation likely covers the main identification numbers, error codes, and security guarantees; this alone is missing the protections and precautions that are distributed elsewhere. Commonly this includes a "Security Considerations" section on details relating to privacy, integrity and trusting the protocol.

Often knowing the actual limitations and hazards takes time, unless you are specifically looking for the right text in the right sections, because they use different language than the primary protocol language.

When the RFC is Not Clear

If the defining text in the RFC seems incomplete or ambiguous, the IETF recommends seeking clarification from the working group that maintains the protocol. The IETF blog states that when questions arise, engaging the relevant mailing list ensures good faith, with skilled and informed participants in protocol definition and implementation.

This can produce an authoritative, textually vetted clarification, revised and included in a later RFC edition. This process can help ensure a specification that is clearer and more normatively robust.

Common Issues

People miss some of the most impactful parts when manually understanding an RFC by not realizing that things outside the text are normative, or that the RFC itself may be unclear where there is casual or unusual capitalisation used.

This is material simply because clients do not instantly know that the formal specifications inherently include the referenced and informational RFC sections; they are designed to be read in a specific way to give every participant an understanding.

Takeaway

The conclusion is that the RFC requirement emerges from the status, keywords, references and errata explicitly specified and compiled by the RFC author, the editors and the working groups. These items help comprise the authentic specification, verified and enforceable where needed.