RFC Readability

From IAB Wiki
Jump to navigation Jump to search

Warning: This is an early brainstorming page

Characetristics of readable RFCs

  • Very short with good examples.
  • Introductory, Architecture, or Roadmap documents for complex topics

Example RFCs and why they're good


  • 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