anatoly techtonik email@example.com added the comment:
Documenting utcoffset() as "Return timedelta equal to local UTC offset." is almost circular. It does not explain whether it has to be added or subtracted from UTC to arrive at local time.
I believe the correct convention is "Return timedelta...".
This is handled inconsistently in the documentation; I'm hoping the current maintainers reinforce the "Returns ..." structure. The documentation is descriptive, not an external specification.
I've took the convention from here. I thought docs are generated from docstrings.