id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
16011	Improve Django documentation search engine results relevancy	info.ksamuel@…	nobody	"It's very hard for beginners to find something if you don't know exactly where to look.

I realize that you probably use a sphynx documentation with the build-in search engine and that integrating something like haystack would be a lot of work, but look:

Looking for a reference of the filter 'join':

http://docs.djangoproject.com/search/?q=filter+join&release=5

Fifth answer, no way to know this is it and once you click have to find to the right section in a huge page.

Now looking for join on the PHP doc:

http://fr.php.net/results.php?q=join&l=en&p=all

First answer, immediate visual clue. Click: you got it.

This is one example, but this happens to people I teach Django to every day.

The Django documentation is very useful and it's a shame that I have to advice to anybody I teach django to to use Google to search the doc.

"	Cleanup/optimization	closed	*.djangoproject.com	1.3	Normal	duplicate	search-engine		Accepted	0	0	0	0	0	0