#25434: Missing documentation for request.site attribute
-------------------------------+------------------------------------
     Reporter:  ngnpope        |                    Owner:  ngnpope
         Type:  Bug            |                   Status:  new
    Component:  Documentation  |                  Version:  1.7
     Severity:  Normal         |               Resolution:
     Keywords:                 |             Triage Stage:  Accepted
    Has patch:  1              |      Needs documentation:  0
  Needs tests:  0              |  Patch needs improvement:  0
Easy pickings:  0              |                    UI/UX:  0
-------------------------------+------------------------------------
Changes (by timgraham):

 * stage:  Unreviewed => Accepted


Comment:

 It seems a bit odd to me to document attributes that middleware set as
 "attributes of `HttpRequest`" but given we have `request.user` documented
 like that, I don't see a big reason not to document this other than
 `request.user` is far more common (enabled my default in new projects)
 than `request.site`. Maybe such attributes could be documented in a
 separate section (as a separate ticket) to make it more obvious.

 FYI, we aren't making non-critical updates to the 1.7 docs since there's
 no workflow for allowing translating those updates, so we'll probably
 limit this to 1.8.

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

Reply via email to