Difference between revisions of "RFC Readability"

From IAB Wiki
Jump to navigation Jump to search
Line 15: Line 15:
* Biting off more that you can chew
* Biting off more that you can chew
** the flip side: a gazillion tiny documents are hard to read
** the flip side: a gazillion tiny documents are hard to read
* Forward references

Revision as of 23:06, 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
  • Forward references