#18715: Tutorial Page 3 Refactor
-------------------------------------+-------------------------------------
     Reporter:  pydanny              |                    Owner:  aaugustin
         Type:                       |                   Status:  new
  Cleanup/optimization               |                  Version:  1.4
    Component:  Documentation        |               Resolution:
     Severity:  Normal               |             Triage Stage:  Accepted
     Keywords:                       |      Needs documentation:  0
    Has patch:  1                    |  Patch needs improvement:  0
  Needs tests:  0                    |                    UI/UX:  0
Easy pickings:  0                    |
-------------------------------------+-------------------------------------

Comment (by aaugustin):

 I'm not comfortable with the very verbose way of defining urls. Is this
 the canonical style we intend to promote? It's fine to explain the `url()`
 function in detail but in my opinion we should quickly show the more
 concise and common syntax, especially since it appears several times
 further down the document.

 Some sentences reference examples further down the document (I had written
 down the list but I managed to lost it, sorry -- me or someone else will
 have to proof-read the whole document again).

 Otherwise this looks very good to me.

 I've improved the markup and added some information (positional vs.
 keyword arguments, 500.html template, etc. -- I also lost that list). I'm
 attaching a consolidated patch that reflect the state after my edits.

-- 
Ticket URL: <https://code.djangoproject.com/ticket/18715#comment:7>
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 post to this group, send email to django-updates@googlegroups.com.
To unsubscribe from this group, send email to 
django-updates+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to