#27921: Documentation of make_aware() with is_dst is misleading
-------------------------------------+-------------------------------------
     Reporter:  Kevin Christopher    |                    Owner:  nobody
  Henry                              |
         Type:  Bug                  |                   Status:  new
    Component:  Documentation        |                  Version:  master
     Severity:  Normal               |               Resolution:
     Keywords:                       |             Triage Stage:  Accepted
    Has patch:  0                    |      Needs documentation:  0
  Needs tests:  0                    |  Patch needs improvement:  0
Easy pickings:  0                    |                    UI/UX:  0
-------------------------------------+-------------------------------------

Comment (by Aymeric Augustin):

 Sorry for the less than useful first comment :-( What about the following
 clarification:

 > For example, is_dst=True would change a nonexistent time of 2:30 to 1:30
 '''pre-transition''' and is_dst=False would change the time to 3:30
 '''post-transition'''.

 We could also add the following sentence to prevent people from wasting
 their time trying to understand this calculation.

 > This change is arbitrary. It doesn't represent a meaningful conversion.
 It merely modifies the value in order to avoid an exception.'''

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

Reply via email to