Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document the current DEP process #80

Closed
thibaudcolas opened this issue Oct 5, 2023 · 3 comments · Fixed by #81
Closed

Document the current DEP process #80

thibaudcolas opened this issue Oct 5, 2023 · 3 comments · Fixed by #81

Comments

@thibaudcolas
Copy link
Sponsor Member

Can we have documentation for the DEP process as it stands at this point in time, combining what appears to be three different documents?


The README states:

See DEP 1 for details.

Said DEP refers to the Technical Board and to Core Developers, two groups which no longer exist as far as I know.

We have the same issue in Django’s contributor documentation:

Changes to this document require the use of the DEP process, with modifications described in DEP 0010.

DEP 10 is also no longer up-to-date with how Django operates. So – in order to write a DEP, I have to read at least DEP 1, 10, and 12.

@jacobian
Copy link
Member

Super agree. I've wanted to work on this for a bit, but may or may not get around to it anytime soon. If someone wanted to work on a draft, though, I'd 100% have time to review and sort of shepherd it through. Feel free to @ me in a pull request if anyone works on that.

FWIW: I don't think we have to keep DEPs frozen in time. I think my approach would be to update DEP 1 and DEP 10 with the changes, so that DEP 1 becomes the high level "how DEPs work", DEP 10 describes the Steering Council, and DEP 12 is a historical document describing the changes. (But I'm open to other approaches here too.)

@carltongibson
Copy link
Member

FWIW: I don't think we have to keep DEPs frozen in time. ...

There was some umm-ing and err-ing about this when discussing DEP 12 — Are they living documents, or historical records? (I have no great opinion, but clarifying would help.)

@jacobian
Copy link
Member

Indeed, I was one of the um-and-err-ers -- but I now think that having them be fixed static documents cause problems for no real benefit. But yeah, we should clarify -- in an updated DEP 1. We can have the conversation in that PR or on the mailing list/forum etc.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants