Do you feel bad because of the Python docs?

Chris Kaynor ckaynor at zindagigames.com
Wed Mar 6 20:28:10 EST 2013


I actually just tried that, and the results weren't very good.

Using the doc's search feature, the "Reporting Bugs" (and the "About these
documents") page was significantly down the page (about 2/3 of the way) -
not the most obvious result in the pile. All the other searches I could
think of either didn't return either of those pages at all, or they were
also 1/2-2/3 of the way down the page.

The link is also on the main documentation page, but it is, again, near the
bottom, making it hidden from many users. Both of them show up just above
the bottom of the window with it maximized on my screen.

The first of the issues may be difficult to fix, but would likely be fairly
useful - that would generally be my first port of call. The second one is
more minor as most people will scroll down to see whats farther down, if
they go to the main page to find the links.

Chris


On Wed, Mar 6, 2013 at 5:06 PM, alex23 <wuwei23 at gmail.com> wrote:

> On Mar 7, 10:47 am, Rick Johnson <rantingrickjohn... at gmail.com> wrote:
> > That's great Terry, but how will the next person find the link?
>
> Why do you have such a low opinion of others that you think they're
> unable to look up "Reporting Bugs" in the _documentation_?
> --
> http://mail.python.org/mailman/listinfo/python-list
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-list/attachments/20130306/282dc720/attachment.html>


More information about the Python-list mailing list