Skip to content

Commit 5746805

Browse files
authored
Update DEPs terminology to match current landscape (#95)
* Update DEPs terminology to match current landscape * Remove django-developers references from DEP 1
1 parent bc12766 commit 5746805

File tree

5 files changed

+33
-24
lines changed

5 files changed

+33
-24
lines changed

accepted/README.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Approved DEPs
22
=============
33

4-
DEPs that have been approved by the Technical Board and are in the
4+
DEPs that have been approved by the Steering Council and are in the
55
process of being implemented. See `DEP 1 <../final/0001-dep-process.rst>`_ for
6-
details.
6+
details.

draft/0007-dependency-policy.rst

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,8 @@ policy of "no external dependencies allowed."
2424
In a nutshell, the policy is that adding a new external dependency should be
2525
treated similarly to adding a major new feature to Django: it requires a DEP,
2626
demonstration that the dependency is needed, rough consensus among the
27-
community and core team that the chosen dependency, and a final decision by
28-
the Technical Board.
27+
community and core contributors that the chosen dependency,
28+
and a final decision by the Steering Council.
2929

3030
The rest of this document explains the guidelines and process for adding new
3131
dependencies, as well as the background and motivation about why this policy was
@@ -75,7 +75,7 @@ as Django itself. We define "maturity" as:
7575
point-releases of ``foo`` won't break Django.
7676

7777
Again, these are guidelines. At the end of the day, the criteria comes down to
78-
"would we include this code in Django?" The Tech Board has the final call.
78+
"would we include this code in Django?" The Steering Council has the final call.
7979

8080
.. [1] Note the "probably" there. It is, in principle, possible to distribute
8181
C extensions in a way that no longer requires a compiler -- platform-
@@ -122,11 +122,11 @@ Re-evaluating dependencies
122122
--------------------------
123123

124124
During each minor release cycle -- and especially before LTS releases -- the
125-
core team should re-evaluate all existing dependencies. If some dependency is
126-
starting regress on the maturity front (particularly if it has become
127-
unmaintained), we want to identify it early and start looking for backup plans.
128-
This might mean removing the dependency, taking over maintenance ourselves,
129-
looking for funding to pay new maintainers, etc.
125+
core contributors should re-evaluate all existing dependencies. If some
126+
dependency is starting regress on the maturity front (particularly if it has
127+
become unmaintained), we want to identify it early and start looking for backup
128+
plans. This might mean removing the dependency, taking over maintenance
129+
ourselves, looking for funding to pay new maintainers, etc.
130130

131131
Background and Motivation
132132
=========================
@@ -150,8 +150,8 @@ occasional downtime, leading to frustration when trying to deploy to production.
150150
didn't go well. Many users struggled even to get the package installed.
151151

152152
That experience led to a deep suspicion of Python packaging tools among the
153-
Django core team, and a de-facto policy emerged of only requiring the lowest
154-
common denominator: installation via direct download and ``python setup.py
153+
Django core contributors, and a de-facto policy emerged of only requiring the
154+
lowest common denominator: installation via direct download and ``python setup.py
155155
install``. This meant not using any of Python's packaging features developed
156156
since about 2002, including most notably dependencies. In 2016, Django's only
157157
dependencies are optional.
@@ -185,7 +185,7 @@ we took full advantage of features now available.
185185

186186
In particular, external dependencies -- other packages specified in
187187
``setup.py``'s ``install_requires`` argument -- should be fair game to add to
188-
Django, when appropriate. Django core developers often duplicate effort
188+
Django, when appropriate. Django core contributors often duplicate effort
189189
re-implementing features that are available as dependencies. And, much of the
190190
time, those external implementations are substantially better than what's
191191
included in Django. For example:
@@ -213,6 +213,12 @@ specifically -- there may be good arguments both for and against each specific
213213
example. They're offered here as examples to of the types of options that open
214214
up once we start to allow external dependencies.
215215

216+
Revision History
217+
================
218+
219+
2024-10-04
220+
Updates to reflect current governance.
221+
216222
Copyright
217223
=========
218224

final/0001-dep-process.rst

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -104,8 +104,8 @@ or too broad. If in doubt, split your DEP into several well-focused ones.
104104

105105
The DEP Author (see below for the formal definition of an Author)
106106
should first attempt to ascertain whether the idea is DEP-able. Posting to
107-
`django-developers <https://docs.djangoproject.com/en/dev/internals/mailing-
108-
lists /#django-developers-mailing-list>`_ is the best way to go about this.
107+
`Django Internals on the forum <https://forum.djangoproject.com/c/internals/5>`_
108+
is the best way to go about this.
109109

110110
Vetting an idea publicly before going as far as writing a DEP is meant to save
111111
the potential author time. Many ideas have been brought forward for changing
@@ -164,7 +164,7 @@ Submitting the draft
164164
--------------------
165165

166166
Once the idea's been vetted and the roles are filled, a draft DEP should be
167-
presented to the Django Forum and/or django-developers. This gives the author a
167+
presented to the Django Forum. This gives the author a
168168
chance to flesh out the draft DEP to make sure it's properly formatted, of high
169169
quality, and to address initial concerns about the proposal.
170170

@@ -176,7 +176,7 @@ until proper formatting rules are followed.
176176

177177
At this point, contributors will review the pull request. In most cases the reviewer
178178
will be the Shepherd of the DEP, but if that's not possible for some reason the
179-
author may want to ask on django-developers and/or the Django Forum to ensure
179+
author may want to ask on the Django Forum to ensure
180180
that this review happens quickly. A reviewer will do the following:
181181

182182
* Read the DEP to check if it is ready: sound and complete. The ideas
@@ -435,7 +435,7 @@ a competing DEP.
435435
If you are interested in assuming ownership of a DEP, first try to contact the
436436
original author and ask for permission. If they approve, ask them to open a pull
437437
request transferring the DEP to you. If the original author doesn't respond to
438-
email within a few weeks, contact django-developers.
438+
email within a few weeks, raise it on the Django Forum.
439439

440440

441441
Differences between DEPs and PEPs
@@ -471,7 +471,7 @@ Relative to the PEP process, we made the following changes in DEPs:
471471
index by status isn't needed.
472472
- DEP file names are more descriptive (e.g. ``0181-orm-expressions.rst``),
473473
again to avoid the need for additional tooling.
474-
- DEPs are "edited" (e.g. pull request approved) by any core developer,
474+
- DEPs are "edited" (e.g. pull request approved) by any core contributor,
475475
rather than an explicit "editor" role like the PEP editors.
476476

477477
- DEPs are pronounced upon by the Steering Council, rather than a BDFL (because
@@ -481,9 +481,9 @@ Relative to the PEP process, we made the following changes in DEPs:
481481
and Shepherd) before submission and throughout the process. With PEPs, most
482482
are authored and implemented by the same person, but the same doesn't seem to
483483
be true of DEPs (so far), hence the "implementer" role. As for the "shepherd":
484-
the BDFL or BDFL-delegate tends to be much more hands-on than the Technical
485-
Board, so the role of commenting and critiquing will be fulfilled by the
486-
shepherd, rather than the board. Further, we've observed that features are
484+
the BDFL or BDFL-delegate tends to be much more hands-on than the Steering
485+
Council, so the role of commenting and critiquing will be fulfilled by the
486+
shepherd, rather than the Council. Further, we've observed that features are
487487
tremendously unlikely to make it into Django without a committer on board to
488488
do the detail-work of merging a patch.
489489

@@ -498,6 +498,9 @@ Relative to the PEP process, we made the following changes in DEPs:
498498
Revision History
499499
================
500500

501+
2024-10-04
502+
Further updates to reflect current governance.
503+
501504
2023-10-23
502505
Updates to reflect changes in governance since this document was originally
503506
written, including changes from "Technical Board" to "Steering Council",

final/0011-accessibility-team.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ terminated by:
5151
- Becoming disqualified due to actions taken by the Code of Conduct committee
5252
of the Django Software Foundation.
5353

54-
- A vote of the Technical Board, or full consensus of the rest of the
54+
- A vote of the Steering Council, or full consensus of the rest of the
5555
Accessibility Team, if the team is considered too large, the person is not
5656
making positive contributions, or any other sound reason.
5757

rejected/README.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
Rejected DEPs
22
=============
33

4-
DEPs that have been rejected by the Technical Board.
4+
DEPs that have been rejected by the Steering Council.
55
See `DEP 1 <../final/0001-dep-process.rst>`_ for details.

0 commit comments

Comments
 (0)