A Chef RFC is a design document describing improvements to Chef. We as a community use RFCs to document, discuss, and plan improvements to Chef and other Chef ecosystem tools. You can always find the list of accepted RFCs at https://github.com/chef/chef-rfc.
The specific projects covered by this process are detailed in RFC002 (Scope).
RFCs are managed in the chef-rfc GitHub repository. When creating a new
RFC, add it to the
new/ folder. A template is provided below. Submit a
pull-request with your new RFC. The Editors will review your submission to
ensure it is formatted correctly.
The community will discuss the proposed changes on the pull-request and during regular community meetings (see RFC001). When the Decider feels consensus has been reached, they will accept or reject the RFC.
The Editors will then assign it an RFC number which will be added to the filename and metadata.
Unless otherwise stated, the RFC author is also volunteering to implement the feature or process if accepted.
There's no rule by which to determine the need for a RFC. Some examples to consider are:
Each RFC will generally include the following sections:
This is neither an exhaustive list nor a set of requirements, but it is a good place to start.
All new RFCs start off as drafts. At any point the author(s) can withdraw the RFC if they feel it doesn't merit further discussion. Once consensus is reached, the Decider for the RFC will accept or reject the RFC. For Standards Track RFCs, once the feature is implemented in a released version of the relevant software the RFC is marked as Final, indicating discussion of further changes to the feature should take place in a new RFC. If an RFC is superseded by a later RFC, the original one should be marked as Replaced.
+-------+ +----------+ +-------+ | | | | | | | Draft +--------> Accepted +---+---> Final | | | | | | | | +---+---+ +----+-----+ | +---+---+ | | | | | | +-------+ | | | | | | +-----v-----+ +----v-----+ +------v---+ | | | | | | | Withdrawn | | On Hold | | Replaced | | | | | | | +-----------+ +----------+ +----------+
An accepted RFC may be modified in two ways, depending on the type of RFC:
1) Most RFCs can be updated by opening a pull request against them with the proposed changes. Once the changes are approved by the Decider, the pull request is merged and considered Accepted.
2) To support software implementations meeting the specifications of an RFC, Standards Track RFCs that are Final must be replaced by a new RFC. The Author should specify the RFC that is being replaced using the Replaces header in the metadata of the new RFC. Once Accepted, the replaced RFC with have its status updated to Replaced by an Editor.
--- RFC: unassigned Title: Title Goes Here Author: Alan Smithee <firstname.lastname@example.org> Status: Draft Type: <Standards Track, Informational, Process> <Replaces: RFCxxx> <Tracking:> < - https://github.com/chef/chef/issues/X> --- # Title Description and rationale. ## Motivation As a <<user_profile>>, I want to <<functionality>>, so that <<benefit>>. ## Specification A detailed description of the planned implementation, which the RFC author agrees to execute. ## Downstream Impact Which other tools will be impacted by this work? ## Copyright This work is in the public domain. In jurisdictions that do not allow for this, this work is available under CC0. To the extent possible under law, the person who associated CC0 with this work has waived all copyright and related or neighboring rights to this work.
This work is in the public domain. In jurisdictions that do not allow for this, this work is available under CC0. To the extent possible under law, the person who associated CC0 with this work has waived all copyright and related or neighboring rights to this work.