This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author steven.daprano
Recipients arkevorkhat, docs@python, steven.daprano
Date 2021-06-22.09:09:07
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1624352947.78.0.665709457587.issue44485@roundup.psfhosted.org>
In-reply-to
Content
Are you referring to this?

https://docs.python.org/3/library/tkinter.html

I acknowledge that there are legitimate criticism of the tkinter docs, and its weaknesses, but you overstate your case.

- Tutorials are documentation, they just aren't *reference* documentation; there are other kinds of documentation, such as Quick Start Guides, How Tos, tutorials, FAQs, man pages, doc strings, etc.

- Tutorials don't necessarily belong on a wiki.

- A structured list of names in the public interface is certainly nice to have, but it shouldn't be taken as the one feature that defines documentation.

- That our docs "... should be the sole authoritative source" is nice to aspire to, but probably not practical in the case of tkinter.

Having said all that, please do submit patches with concrete improvements. Don't feel that you must completely redesign the entire tkinter docs. Incremental improvements are welcome as well.

"3rd party sites of dubious provenance and questionable accuracy"

I don't think that tkdocs.com is any more dubious or questionable than anything we could write; and the tcl/tk documentation at tcl.tk is the one source of truth for tcl/tk. Tkinter is just a third-party interface to it.
History
Date User Action Args
2021-06-22 09:09:07steven.dapranosetrecipients: + steven.daprano, docs@python, arkevorkhat
2021-06-22 09:09:07steven.dapranosetmessageid: <1624352947.78.0.665709457587.issue44485@roundup.psfhosted.org>
2021-06-22 09:09:07steven.dapranolinkissue44485 messages
2021-06-22 09:09:07steven.dapranocreate