Skip to content

Commit

Permalink
Documentation: Add section "Why have an RFC process?"
Browse files Browse the repository at this point in the history
  • Loading branch information
aduth committed May 17, 2019
1 parent e2fd7bc commit 33fb091
Showing 1 changed file with 4 additions and 0 deletions.
4 changes: 4 additions & 0 deletions docs/rfcs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ https://make.wordpress.org/core/2019/04/01/the-block-registration-rfc-and-the-gu

This process is both inspired and informed by other open source projects such as [React](https://github.com/reactjs/rfcs), [Yarn](https://github.com/yarnpkg/rfcs), and [Rust](https://github.com/rust-lang/rfcs), and of technical bodies standardization processes such as [IETF](https://tools.ietf.org/html/rfc2026), [W3C](https://www.w3.org/2004/02/Process-20040205/tr.html), and [TC39](https://tc39.github.io/process-document/).

## Why have an RFC process?

Overcoming complex technical challenges can be difficult in an open-source project where we are typically unable to meet in person to discuss solutions at depth. The RFC process is intended to provide an open venue for detailed, ongoing discussion and iteration. Further, it serves as a living record of the solution for posterity of future maintainers. The process as outlined below allows both for experimentation and focused discussion, keeping an open feedback loop and adapting to information as it becomes known.

## What types of features or problems should be submitted as RFCs?

While an issue can be sufficient to describe small feature requests, an RFC should be proposed for all features with impact across many areas of the code base, new patterns for extensibility APIs, and technical problems that are hard to solve without making compromises.
Expand Down

0 comments on commit 33fb091

Please sign in to comment.