#29301: Reorder management command arguments in --help output to prioritize
command-specific arguments
-------------------------------------+-------------------------------------
     Reporter:  David Foster         |                    Owner:  David
         Type:                       |  Foster
  Cleanup/optimization               |                   Status:  new
    Component:  Core (Management     |                  Version:  2.0
  commands)                          |
     Severity:  Release blocker      |               Resolution:
     Keywords:                       |             Triage Stage:  Accepted
    Has patch:  1                    |      Needs documentation:  0
  Needs tests:  0                    |  Patch needs improvement:  0
Easy pickings:  0                    |                    UI/UX:  0
-------------------------------------+-------------------------------------

Comment (by Carlton Gibson):

 Well, who'd have thought this would have been an issue? You live and
 learn.

 Thanks for the input all.

 Having looked at the two PRs, and given that this issue has come up, I
 think the formatter is the right way to go.

 * It works and is API specifically targeting our usage.
 * Formatting aside, adding the default arguments first probably does make
 sense.
 * It's not clear that the `_try_add_argument` wouldn't add a further bug
 that we run into later-on.

 We should document in the release notes that the new formatter is used, so
 if it does break anything people know to adjust.
 (I think the small BC risk here is worth the extra readability for normal
 case.)

-- 
Ticket URL: <https://code.djangoproject.com/ticket/29301#comment:17>
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 post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.7cbc6f939260c02fa252da74f07e0e0b%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to