Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

> Today when you search for 'random.choice python' you get to the random front page with 20+ random

I prefer a single page for random than having 20 something pages for random.x. Here is the doc for random.choice:

    random.choice(seq)
    Return a random element from the non-empty sequence seq. If seq is empty, raises IndexError.
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.



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.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: