Re:Python.org Redesign Request for Proposals
by benhoyt on Wednesday May 23, 2012 @10:13AM
(#4013121)
Funny -- I've used Python and its online docs for many years and never used their search, I always use Google. :-) Google search with site:docs.python.org does a somewhat better job: http://www.google.com/#hl=en&sclient=psy-ab&q=string...
Re:Python.org Redesign Request for Proposals
by Eventh on Wednesday May 23, 2012 @01:07PM
(#4014020)
Part of the problem is the use of Sphinx and its search engine (at least this was the case a year ago), where searching happens client-side in JavaScript. This limits how complex the search engine can be, before it is to slow or require to much data to download. Last time I looked it had a simple inverse index with a Porter stemmer and limited ranking of results.
This is great for documentation of most projects as it can be supported with only html+css+js, without a need for a web framework and hosting. But for the documentation of a major programming language I think something more advanced is expected.
Re:Python.org Redesign Request for Proposals
by jsprinkles on Wednesday May 23, 2012 @07:36PM
(#4015878)
The documentation for Python is mediocre at best, which is a wart of how documenting Python works. I think the newer Sphynx site is actually a regression from what they had in the Python 2.5 days.
http://docs.python.org/
The first relevant result for searching "string concatenation" is around the 20th place.
http://docs.python.org/search.html?q=string+concatenation