#16988 closed Cleanup/optimization (fixed)
update/cleanup deprecation timeline
Reported by: | Preston Holmes | Owned by: | Preston Holmes |
---|---|---|---|
Component: | Documentation | Version: | dev |
Severity: | Release blocker | Keywords: | |
Cc: | Triage Stage: | Accepted | |
Has patch: | yes | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | yes |
Easy pickings: | no | UI/UX: | no |
Description
Update deprecation timeline for 1.4 release, attempt to make language clearer and more consistent per this discussion:
http://groups.google.com/group/django-developers/t/76cd67a971f3c98a
Change History (6)
comment:1 by , 13 years ago
Has patch: | set |
---|---|
Owner: | changed from | to
Status: | new → assigned |
comment:2 by , 13 years ago
Patch needs improvement: | set |
---|---|
Triage Stage: | Unreviewed → Accepted |
Looks really good to me! I'm just made a couple of very minor comments inline at: https://github.com/django/django/pull/58/files
As a general comment, I think it might be worth adding a small paragraph at the beginning of that page explaining how the deprecation process works in Django (e.g. what the word "deprecation" means in this context; quiet vs. loud deprecation warnings, etc.). What do you think?
comment:3 by , 13 years ago
Looks great, thanks for your work on this! I also reviewed and made some inline comments on the pull request.
Julien, I think that more general information about the deprecation process is already present in the release-process documentation, and that's linked from the top of the deprecation timeline. Seems adequate that way to me?
comment:4 by , 13 years ago
Patch needs improvement: | unset |
---|
updated pull request with inline comments, thanks guys.
RE deprecation process, I think only thing missing is a short mention that the process will be accelerated in rare cases, or for security reasons, but such clarification is not critical.
ready for additional review or checkin
comment:5 by , 13 years ago
Patch needs improvement: | set |
---|
Added three or four more minor notes, but this is almost ready IMO.
Pull request submitted, feedback welcome
https://github.com/django/django/pull/58