Difference between revisions of "RFC Readability"

From IAB Wiki
Jump to navigation Jump to search
Line 7: Line 7:
== Example RFCs and why they're good ==
== Example RFCs and why they're good ==


=== IMAP ===
=== IMAP: RFC3501 ===
 
[RFC3501]


* Solid examples throughout the document
* Solid examples throughout the document

Revision as of 22:44, 13 January 2021

Warning: This is an early brainstorming page

Characetristics of readable RFCs

  • Very short with good examples.

Example RFCs and why they're good

IMAP: RFC3501

  • Solid examples throughout the document

Things that don't work

  • Biting off more that you can chew
    • the flip side: a gazillion tiny documents are hard to read