Steven D'Aprano <steve+pyt...@pearwood.info> added the comment:
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. ---------- nosy: +steven.daprano type: behavior -> enhancement _______________________________________ Python tracker <rep...@bugs.python.org> <https://bugs.python.org/issue44485> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
