Re:Python.org Redesign Request for Proposals
by hising on Wednesday May 23, 2012 @12:10PM
(#4013728)
As you see in my comment, I do not agree with you, but realize that "some people like to have the full spec for all random functions in one page...".
It is not overkill as I see it, a page for random.choice with official documentation and annotations and comments would be good in my book.
I prefer a single page for random than having 20 something pages for random.x. Here is the doc for random.choice:
A separate page for this will be textbook definition of overkill.If you already know what you are looking for(random.choice), a better way to lookup the docs is to either use the repl(help(random.choice)) or configure your editor to lookup the documentation. Python library docs is mostly contained in the docstrings.