Opened 8 years ago

Closed 8 years ago

Last modified 8 years ago

#27174 closed Cleanup/optimization (fixed)

Explain where 'polls.apps.PollsConfig' comes from in tutorial 2

Reported by: Sanket Owned by: Ankur Gupta
Component: Documentation Version: 1.10
Severity: Normal Keywords: docs
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

In tutorial02.txt, polls.apps.PollsConfig is introduced without much explanation, which may be slightly confusing for first-time readers. It would be good to have some explanation of why we use that specific string in this context.

Change History (10)

comment:1 by Sanket, 8 years ago

Owner: changed from nobody to Sanket
Status: newassigned

comment:2 by Sanket, 8 years ago

Owner: Sanket removed
Status: assignednew

comment:3 by Ankur Gupta, 8 years ago

Needs documentation: set
Owner: set to Ankur Gupta
Status: newassigned

comment:4 by Ankur Gupta, 8 years ago

Does someone reviews this or should I just make the change?

comment:5 by Tim Graham, 8 years ago

Needs documentation: unset
Summary: Explicitly define where string comes fromExplain where 'polls.apps.PollsConfig' comes from in tutorial 2
Triage Stage: UnreviewedAccepted

comment:6 by Ankur Gupta, 8 years ago

Has patch: set

I have submitted a PR for this (https://github.com/django/django/pull/7211).

This change also needs to be made back to Django 1.9. Can anyone help me in how to backport documentation changes? Do I need to merge this change with 1.9.x and 1.10.x branches?

comment:7 by Tim Graham <timograham@…>, 8 years ago

Resolution: fixed
Status: assignedclosed

In 40d50114:

Fixed #27174 -- Explained where PollsConfig comes from in tutorial 2.

comment:8 by Tim Graham <timograham@…>, 8 years ago

In 9a03d30d:

[1.10.x] Fixed #27174 -- Explained where PollsConfig comes from in tutorial 2.

Backport of 40d501147176352b694ec8b67b09127b20193ad2 from master

comment:9 by Ankur Gupta, 8 years ago

Hi Tim,

This also needs to be backported for 1.9.x

comment:10 by Tim Graham, 8 years ago

We don't update older versions of the docs except for critical mistakes.

Note: See TracTickets for help on using tickets.
Back to Top