[issue10858] Make source code links less proeminent

Antoine Pitrou report at bugs.python.org
Fri Jan 7 20:56:47 CET 2011


Antoine Pitrou <pitrou at free.fr> added the comment:

> The goal is to reacquaint people with the source as an adjunct to the
> docs.  The phrase use-the-source-luke used to be common in the python
> community but now many devs don't seem to be able to readily access
> the source (with it tucked away in a library directory).

I don't think someone "not able to readily access the source" from a
link at the *bottom* of a doc page would be able to understand (or even
be motivated to understand) the stdlib's source code.

While I understand the motivation to encourage reading of the source
code, this should not disrupt the sequential reading of documentation
pages, or make it seem more important than the API docs themselves.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10858>
_______________________________________


More information about the Python-bugs-list mailing list