#32654: docstring in modules created by startapp
-------------------------------------+-------------------------------------
     Reporter:  Sandro Covo          |                    Owner:  nobody
         Type:  Uncategorized        |                   Status:  closed
    Component:  Core (Management     |                  Version:  3.2
  commands)                          |
     Severity:  Normal               |               Resolution:  wontfix
     Keywords:  startapp             |             Triage Stage:
  documentation                      |  Unreviewed
    Has patch:  0                    |      Needs documentation:  0
  Needs tests:  0                    |  Patch needs improvement:  0
Easy pickings:  1                    |                    UI/UX:  0
-------------------------------------+-------------------------------------
Changes (by Carlton Gibson):

 * status:  new => closed
 * resolution:   => wontfix


Comment:

 I'm going to say wontfix here: the templates used to be more complicated,
 but were deliberately simplified as the included details were not really
 read, were not as detailed as the docs, and were considered overwhelming.

 The consensus was to keep the templates clean and have users go to the
 docs, which will always be canonical and provide either tutorial, guide,
 or reference detail at the level which is appropriate for the user in
 hand.

 See discussion: https://groups.google.com/g/django-
 developers/c/y2VJgVXJuMo/m/tBtioYUvphcJ

 A change of policy would require agreement on the DevelopersMailingList,
 but given the past discussion I would suspect that to be unlikely.

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

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/064.4656548bf49acfcb4b2c9a7c78ca106b%40djangoproject.com.

Reply via email to