[issue44485] TKinter docs page does not provide actual documentation

2021-06-22 Thread Chris Trent


New submission from Chris Trent :

The documentation pages for the tkinter module are not actually documentation. 
They are tutorials, which belong on the wiki. "Documentation" is not 
documentation if it does not provide at bare minimum a structured list of all 
names exposed by the module's public interface. 

Python's official docs should be the sole authoritative source for full, 
complete, useful documentation of everything one could need to know about a 
module, but instead, We're forced to go to 3rd party sites of dubious 
provenance and questionable accuracy, instead of being able to just go to the 
source, and find a page to, I don't know, find out what kinds of panels we have 
to work with.

--
assignee: docs@python
components: Documentation
messages: 396313
nosy: arkevorkhat, docs@python
priority: normal
severity: normal
status: open
title: TKinter docs page does not provide actual documentation
versions: Python 3.9

___
Python tracker 
<https://bugs.python.org/issue44485>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue44485] TKinter docs page does not provide actual documentation

2021-06-22 Thread Chris Trent


Change by Chris Trent :


--
type:  -> behavior

___
Python tracker 
<https://bugs.python.org/issue44485>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue44485] TKinter docs page does not provide actual documentation

2021-06-22 Thread Chris Trent


Chris Trent  added the comment:

To put it bluntly, having me submit patches to that section of the docs is just 
about the last thing you want. I know precious little about TKinter, which is 
precisely why I'm calling for something more than a half-assed tutorial.

Regarding using the TCL/TK docs, not happening. I don't have the time nor 
patience to learn a dead scripting language just to read docs, if I wanted to 
do that, I'd learn Javascript.

--

___
Python tracker 
<https://bugs.python.org/issue44485>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com