[Django] #17048: Add Docs for Guidelines for Upgrading an Existing Project's Django

11 views
Skip to first unread message

Django

unread,
Oct 13, 2011, 5:19:13 PM10/13/11
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+-----------------------
Reporter: dstufft | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: SVN
Severity: Normal | Keywords: upgrading
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------+-----------------------
A decent addition to the docs would be a short page about the general
process to go about replacing a projects version of django with a new one.

It would include any concerns/considerations that a developer should look
at when doing the upgrade. One such thing is that starting with python
2.7, Deprecation warnings are silenced by default (the thinking being that
end users don't care about them). So when upgrading Django you should use
something like ``python -Wall manage.py test`` or ``python -Wd manage.py
test`` to check for any warnings.

--
Ticket URL: <https://code.djangoproject.com/ticket/17048>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Oct 13, 2011, 5:20:55 PM10/13/11
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+------------------------------------
Reporter: dstufft | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: SVN
Severity: Normal | Resolution:
Keywords: upgrading | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------+------------------------------------
Changes (by carljm):

* needs_better_patch: => 0
* needs_docs: => 0
* needs_tests: => 0
* stage: Unreviewed => Accepted


Comment:

We already have a note about running with `-Wall` on the testing page, but
that's not a place someone upgrading is likely to look. I think a short
"Django upgrade checklist" page would be a good addition to the docs.

--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:1>

Django

unread,
Mar 28, 2013, 3:16:08 AM3/28/13
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+------------------------------------
Reporter: dstufft | Owner: susan
Type: New feature | Status: assigned
Component: Documentation | Version: master

Severity: Normal | Resolution:
Keywords: upgrading | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 1 | UI/UX: 0
-------------------------------+------------------------------------
Changes (by susan):

* owner: nobody => susan
* status: new => assigned


--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:2>

Django

unread,
Apr 13, 2013, 5:20:42 PM4/13/13
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+------------------------------------
Reporter: dstufft | Owner: susan
Type: New feature | Status: assigned
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: upgrading | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 1 | UI/UX: 0
-------------------------------+------------------------------------

Comment (by anonymous):

I've attempted to resolve this ticket in my PR:
https://github.com/django/django/pull/1012 Feel free to code review.

--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:3>

Django

unread,
Apr 18, 2013, 2:16:53 PM4/18/13
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+------------------------------------
Reporter: dstufft | Owner: susan
Type: New feature | Status: assigned
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: upgrading | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 1 | UI/UX: 0
-------------------------------+------------------------------------
Changes (by timo):

* has_patch: 0 => 1


--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:4>

Django

unread,
May 10, 2013, 4:21:36 PM5/10/13
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+------------------------------------
Reporter: dstufft | Owner: susan
Type: New feature | Status: assigned
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: upgrading | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 1 | UI/UX: 0
-------------------------------+------------------------------------

Comment (by EvilDMP):

I have tentatively reserved this ticket for first-time committers who take
part in the [https://dont-be-afraid-to-commit.readthedocs.org/ Don't be
afraid to commit workshop] at the [http://2013.djangocon.eu/ DjangoCon
Europe 2013] sprints on 18th and 19th May.

If you want to tackle this ticket before then, please '''don't''' let the
fact that it's assigned to me stop you. Feel free to re-assign it to
yourself and do whatever you like to it.

--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:5>

Django

unread,
May 10, 2013, 4:22:36 PM5/10/13
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+------------------------------------
Reporter: dstufft | Owner: EvilDMP

Type: New feature | Status: assigned
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: upgrading | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 1 | UI/UX: 0
-------------------------------+------------------------------------
Changes (by EvilDMP):

* owner: susan => EvilDMP


--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:6>

Django

unread,
May 18, 2013, 10:48:27 AM5/18/13
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+-------------------------------------
Reporter: dstufft | Owner: anonymous

Type: New feature | Status: assigned
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: upgrading | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 1 | UI/UX: 0
-------------------------------+-------------------------------------
Changes (by crainbf@…):

* owner: EvilDMP => anonymous


--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:7>

Django

unread,
May 20, 2013, 7:59:00 AM5/20/13
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+-------------------------------------
Reporter: dstufft | Owner: anonymous
Type: New feature | Status: assigned
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: upgrading | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 1 | UI/UX: 0
-------------------------------+-------------------------------------
Changes (by timo):

* cc: timograham@… (added)
* needs_better_patch: 0 => 1


Comment:

Updated pull request (still needs some polish):
https://github.com/django/django/pull/1173

--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:8>

Django

unread,
May 22, 2013, 8:55:18 AM5/22/13
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+-------------------------------------
Reporter: dstufft | Owner: anonymous
Type: New feature | Status: closed
Component: Documentation | Version: master
Severity: Normal | Resolution: fixed

Keywords: upgrading | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 1 | UI/UX: 0
-------------------------------+-------------------------------------
Changes (by Tim Graham <timograham@…>):

* status: assigned => closed
* resolution: => fixed


Comment:

In [changeset:"ef8a9bc7fafc394f2c413a6ad4057d67134d742b"]:
{{{
#!CommitTicketReference repository=""
revision="ef8a9bc7fafc394f2c413a6ad4057d67134d742b"
Fixed #17048 - Added docs for upgrading Django.

Thanks Donald Stufft for the suggestion and
Susan Tan and Brian Fabian Crain for the patch.
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:9>

Django

unread,
May 22, 2013, 8:59:02 AM5/22/13
to django-...@googlegroups.com
#17048: Add Docs for Guidelines for Upgrading an Existing Project's Django
-------------------------------+-------------------------------------
Reporter: dstufft | Owner: anonymous
Type: New feature | Status: closed
Component: Documentation | Version: master
Severity: Normal | Resolution: fixed
Keywords: upgrading | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 1 | UI/UX: 0
-------------------------------+-------------------------------------

Comment (by Tim Graham <timograham@…>):

In [changeset:"1add64684cef6877bf0faeb4a205be6ae07fc98e"]:
{{{
#!CommitTicketReference repository=""
revision="1add64684cef6877bf0faeb4a205be6ae07fc98e"
[1.5.x] Fixed #17048 - Added docs for upgrading Django.

Thanks Donald Stufft for the suggestion and
Susan Tan and Brian Fabian Crain for the patch.

Backport of ef8a9bc7fa from master.
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/17048#comment:10>

Reply all
Reply to author
Forward
0 new messages