<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Thu, Sep 3, 2015 at 4:55 PM, Alexander Belopolsky <span dir="ltr"><<a href="mailto:alexander.belopolsky@gmail.com" target="_blank">alexander.belopolsky@gmail.com</a>></span> wrote:<br><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Doc patches from good writers are always welcome, but in this case, I don't see what needs to be added to what the reference manual already says:<br></div></blockquote><div><br></div><div>Wow -- I did not find that when I went looking early in this thread -- so maybe not missing, but not in an easy  to find place.</div><div><br></div><div>The trick with docs is that:</div><div><br></div><div>a) people don't read them ;-) </div><div><br></div><div>b) OK, they do when they can't figure out how to do something -- in which case, they read as little as they can to solve their problem.</div><div><br></div><div>The trick with datetime arithmetic is that people come to it with an expectation of how it works, so we want to make sure they won't go away with that that expectation (if it's wrong) with a quick read of the docs. This is particularly a problem because datetime arithmetic behaves like both Period and Duration arithmetic if you stay away from DST -- so folks can come in with either expectation and their code could work fine, and not find an the issue until it fails next fall.</div><div><br></div><div>And yes, I could have written some nice doc patches with the time I've spent on this thread -- but that's less fun!</div><div><br></div><div>And maybe we should wait for post-PEP, so we know what to write (if anything different).</div><div><br></div><div>-Chris</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><a href="https://docs.python.org/3/library/datetime.html#datetime.datetime" target="_blank">https://docs.python.org/3/library/datetime.html#datetime.datetime</a><br><br>The only improvement that comes to mind is to make "Supported operations:" a linkable section.<br></div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><br>Christopher Barker, Ph.D.<br>Oceanographer<br><br>Emergency Response Division<br>NOAA/NOS/OR&R            (206) 526-6959   voice<br>7600 Sand Point Way NE   (206) 526-6329   fax<br>Seattle, WA  98115       (206) 526-6317   main reception<br><br><a href="mailto:Chris.Barker@noaa.gov" target="_blank">Chris.Barker@noaa.gov</a></div>
</div></div>