search

python / cpython

The Python programming language
https://www.python.org/
Other
60.06k stars 29.08k forks source link

gh-85453: Fix 'time zone' spelling issues across datetime.rst #118449

Open uatach opened 2 weeks ago

uatach commented 2 weeks ago

Another pull request based on PR #21447, this one focused on fixing spelling issues on occurrences of 'time zone'.

📚 Documentation preview 📚: https://cpython-previews--118449.org.readthedocs.build/

pganssle commented 2 weeks ago

I think timezone is also an acceptable spelling, if that's what we've been consistently using, we should probably continue using that.

Alternatively, we could differentiate between datetime.timezone (the class) and the more abstract notion of a "time zone" by including the space for the abstract notion, but I'm more inclined to mark out references to the class with backticks / class references rather than a spelling difference.

uatach commented 2 weeks ago

I think timezone is also an acceptable spelling, if that's what we've been consistently using, we should probably continue using that.

I'm not sure... the IANA database uses "time zone" and both Wikipedia and The Free Dictionary redirect "timezone" to "time zone"... so maybe "timezone" isn't even valid spelling but people use it anyway?

Alternatively, we could differentiate between datetime.timezone (the class) and the more abstract notion of a "time zone" by including the space for the abstract notion, but I'm more inclined to mark out references to the class with backticks / class references rather than a spelling difference.

Yes, I tried to differentiate all of them (the class and the instances and objects of the class) from the abstract concept.