#25473: Docs: 'author-detail' vs 'author_update'
-------------------------------------+-------------------------------------
     Reporter:  guettli              |                    Owner:  nobody
         Type:                       |                   Status:  new
  Cleanup/optimization               |
    Component:  Documentation        |                  Version:  1.8
     Severity:  Normal               |               Resolution:
     Keywords:                       |             Triage Stage:
                                     |  Unreviewed
    Has patch:  0                    |      Needs documentation:  0
  Needs tests:  0                    |  Patch needs improvement:  0
Easy pickings:  0                    |                    UI/UX:  0
-------------------------------------+-------------------------------------
Changes (by guettli):

 * needs_docs:   => 0
 * needs_tests:   => 0
 * needs_better_patch:   => 0


Old description:

> Please use **one** form to refer to the update-view of
> a model.
>
> Here are two:  'author-detail' vs 'author_update'
>
> {{{
>     def get_absolute_url(self):
>         return reverse('author-detail', kwargs={'pk': self.pk})
> }}}
>
> from https://docs.djangoproject.com/en/1.8/topics/class-based-views
> /generic-editing/#model-forms
>
> some lines below the above link:
> {{{
>     url(r'author/(?P<pk>[0-9]+)/$', AuthorUpdate.as_view(),
> name='author_update'),
> }}}

New description:

 Please use **one** form to refer to the update-view of
 a model.

 Here are two:  'author-detail' vs 'author_update'

 {{{
     def get_absolute_url(self):
         return reverse('author-detail', kwargs={'pk': self.pk})
 }}}

 from https://docs.djangoproject.com/en/1.8/topics/class-based-views
 /generic-editing/#model-forms

 some lines below the above link:
 {{{
     url(r'author/(?P<pk>[0-9]+)/$', AuthorUpdate.as_view(),
 name='author_update'),
 }}}


 But first: The django core developers should decide which pattern should
 be used in the docs:

 foo-detail or foo_update.

 When the decision was made, then all examples in the docs should use this
 pattern.

--

--
Ticket URL: <https://code.djangoproject.com/ticket/25473#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 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/065.78ae6acf0ae9c698f1b62f5bb365c2cf%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to