You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
M. J. Fromberger 2f9355c579
docs: fix ToC file extension for RFC 004. (#7813)
3 years ago
..
README.md docs: fix ToC file extension for RFC 004. (#7813) 3 years ago
rfc-000-p2p-roadmap.rst rfc: Fix a few typos and formatting glitches p2p roadmap (#6960) 3 years ago
rfc-001-storage-engine.rst rfc: database storage engine (#6897) 3 years ago
rfc-002-ipc-ecosystem.md RFC 002 Interprocess Communication in Tendermint (#6913) 3 years ago
rfc-003-performance-questions.md rfc: add performance taxonomy rfc (#6921) 3 years ago
rfc-004-e2e-framework.rst rfc: e2e improvements (#6941) 3 years ago
rfc-005-event-system.rst rfc: event system (#6957) 3 years ago
rfc-006-event-subscription.md RFC 006: Event Subscription (#7184) 3 years ago
rfc-007-deterministic-proto-bytes.md rfc: deterministic proto bytes serialization (#7427) 3 years ago
rfc-008-don't-panic.md rfc: don't panic (#7472) 3 years ago
rfc-009-consensus-parameter-upgrades.md RFC-009: Consensus Parameter Upgrades (#7524) 3 years ago
rfc-010-p2p-light-client.rst rfc: p2p light client (#7672) 3 years ago
rfc-011-delete-gas.md RFC: add delete gas rfc (#7777) 3 years ago
rfc-template.md ADR 072: Re-instate a request-for-comments archive. (#6851) 3 years ago

README.md

order parent
1 [{order false}]

Requests for Comments

A Request for Comments (RFC) is a record of discussion on an open-ended topic related to the design and implementation of Tendermint Core, for which no immediate decision is required.

The purpose of an RFC is to serve as a historical record of a high-level discussion that might otherwise only be recorded in an ad hoc way (for example, via gists or Google docs) that are difficult to discover for someone after the fact. An RFC may give rise to more specific architectural decisions for Tendermint, but those decisions must be recorded separately in Architecture Decision Records (ADR).

As a rule of thumb, if you can articulate a specific question that needs to be answered, write an ADR. If you need to explore the topic and get input from others to know what questions need to be answered, an RFC may be appropriate.

RFC Content

An RFC should provide:

  • A changelog, documenting when and how the RFC has changed.
  • An abstract, briefly summarizing the topic so the reader can quickly tell whether it is relevant to their interest.
  • Any background a reader will need to understand and participate in the substance of the discussion (links to other documents are fine here).
  • The discussion, the primary content of the document.

The rfc-template.md file includes placeholders for these sections.

Table of Contents