Skip to content

Commit c9c6414

Browse files
committed
Add Steering Council guidance and documentation.
1 parent cec4317 commit c9c6414

File tree

1 file changed

+61
-3
lines changed

1 file changed

+61
-3
lines changed

README.md

Lines changed: 61 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22

33
## TODOs
44

5-
- Write up instructions for SC / Feature Review team for each phase
6-
- Generate URLs for various queues for people to bookmark
75
- Update new idea process to mention they should search existing ideas first
86

97
## Have an idea for Django?
@@ -202,9 +200,69 @@ likely the person or group of people who will be implementing the feature.
202200

203201
Please share your opinions on the [Forum](https://forum.djangoproject.com/c/internals/5).
204202

205-
## Steering Council instructions
203+
## Steering Council guidance
206204

207205
There are several tasks that the Steering Council should take to
208206
maintain the backlog of ideas. Not every idea must be reviewed at
209207
every interval, but some ideas should constantly be moving forward.
210208

209+
### Triaging new ideas
210+
211+
- [Queue to review](https://github.com/tim-schilling/new-features/issues?q=is%3Aissue%20state%3Aopen%20(no%3Alabel%20OR%20label%3A%22phase%20%2F%20new%22))
212+
- Any relevant labels should be applied to the issue
213+
- If the issue is a duplicate of another, it should be closed and referred to the original
214+
- The concerns of triaging are:
215+
- Clarity of the proposal
216+
- Label usage
217+
- Duplicates
218+
219+
### Determining consensus on community support
220+
221+
- [Queue to review](https://github.com/tim-schilling/new-features/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22phase%20%2F%20is%20there%20community%20support%22%20)
222+
- The issues should be reviewed to determine if the community has arrived at consensus
223+
- The question here is, “Does the community think this change is good for Django?”
224+
- People who expressed significant disagreement may be asked to explain their disagreement
225+
- When reviewing the issue, ignore the following as it’s irrelevant to this stage of the process
226+
- It’s really hard to do
227+
- We don’t have the capacity to implement this
228+
- Potential results
229+
- Nothing, because community discussion is ongoing or more is needed
230+
- Consensus on yes, remove the "Is there community support" label and add "Is this expected in Django" label
231+
- Consensus on no, the issue is closed
232+
- The discussion and decision should be summarized into a single post by the team
233+
- Next steps need to be communicated
234+
235+
### Determining is this expected in Django
236+
237+
- [Queue to review](https://github.com/tim-schilling/new-features/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22phase%20%2F%20is%20this%20expected%20in%20core%22)
238+
- The issue should be reviewed to determine if the idea is expected to be in Django
239+
- Features that should be merged into core Django are:
240+
- Proven to be integral to Django a significant number of applications
241+
- The design or need of the feature going to be stable for years
242+
- When reviewing the issue, ignore the following as it’s irrelevant to this stage of the process
243+
- It’s really hard to do
244+
- We don’t have the capacity to implement this
245+
- Feasibility of making it a third-party app
246+
- The changes to support an easier integration should be proposed separately
247+
- Potential results
248+
- Nothing, because community discussion is ongoing or more is needed
249+
- Consensus on yes, remove the "Is this expected in Django" label and add "needs SC DEP" label
250+
- Consensus on no, the issue is closed or remove "Is this expected in Django" label and add "third-party package" label
251+
- The discussion and decision should be summarized into a single post by the team
252+
- Next steps need to be communicated
253+
254+
### Creating DEPs for expected features
255+
256+
- [Queue to review](https://github.com/tim-schilling/new-features/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22phase%20%2F%20needs%20SC%20DEP%22)
257+
- The issue should have a DEP created at
258+
- It should contain the following sections:
259+
- Title
260+
- Preamble
261+
- Abstract
262+
- Motivation
263+
- Rationale
264+
- Copyright
265+
- The technical detail sections can be left for the community member who implements the feature
266+
- When the Steering Council agrees on the above sections:
267+
1. Remove "needs SC DEP" label and add "needs community DEP"
268+
2. Add links/references between DEP draft and the feature idea issue

0 commit comments

Comments
 (0)