Some changes to DevTools need feedback from the team and community to reach a consensus. In such cases we should use the RFC process to discuss the proposed changes.
We aim for the process to be lightweight and focused on conversations. Therefore opening a DevTools RFC is as easy as opening an issue in this repository.
The DevTools RFC team will be ultimately responsible for accepting or rejecting proposals, but the discussion is open to everybody.
The list of RFCs currently under discussion can be found at Active RFCs.
What kind of changes should be discussed?
We aim to discuss specific and actionable changes, i.e. we aim to answer questions about work you're doing or about to do either on the DevTools codebase or on something that interacts with DevTools. For example:
- you're working on a DevTools bug, and you believe the fix involves making a change that affects a number of panels or doing something that is very different from the existing conventions, and you would like feedback on the solution you came up with.
- you are about to make a breaking change on an essential API we interact with, and would like to discuss it and get feedback from us beforehand.
This distinction can be unclear at times, but we will try our best to discuss proposals, taking into account our own time limitations.
- Create an issue detailing what you're seeking feedback on
- Get people's attention. Some options:
- Gather feedback by discussing in the issue
The team will send an email a few days prior to the review meeting to dev-developer-tools to announce which RFCs are going to be reviewed, and encourage peers to comment if needed.
After a proposal has been discussed and consensus has been reached, the DevTools core team will label the issue either as
rejected, and will add a comment summarising the decision.
If the RFC is accepted, the team will also create an item in the appropriate medium (e.g. bugzilla bug, github issue, airtable item) to ensure the decision is adequately documented and the proposal is tracked.
The issue will then be closed, regardless of the accepted status. This ends the involvement of the team with regards to that RFC.
You can have a look at the following links to get an idea of which RFCs are in each state: