gh-138277: Elevate Built-in Types and Functions in Documentation Search

[adqm]

This patch adds a custom search scorer for the Python docs, in the hopes of making the search results more useful. For now, this just increases the score of built-in functions and types so that they show up closer to the top of the relevant search results, though it also opens the door to other improvements. I also have a couple of other ideas that might further improve the ordering, but I figured it'd be best to start small.

With this change:

• When searching "str", the built-in str type goes from being the 44th result to the 1st.
• When searching "set", the built-in set type goes from being the 14th result to the 1st.
• When searching "int", the built-in int type now shows up above tkinter and pprint.

I don't think this needs a news item, but I can add one if y'all think it's necessary.

• Issue: Ordering of search results in the docs could be improved #138277

---

📚 Documentation preview 📚: https://cpython-previews--138278.org.readthedocs.build/

[skirpichev]

I'm played with this a bit and I generally like new search output 👍

[adqm]

Thanks for taking a look, @skirpichev! I just pushed a few changes, adding some comments and tweaking the scoring a little bit (to adjust one value that I inadvertently changed from the sphinx defaults that was affecting the ordering more than I intended).

Looking around a bit more, though, I am wondering if it might be better to do this with a Sphinx object domain, though, setting the builtin things to be important. But I'm not sure if there's an easy way to do that without hard-coding all of the built-in objects somewhere. @AA-Turner might know better. Then again, some of the other changes I had been thinking of probably do require a score function anyway...

[StanFromIreland]

The file does not belong in the root Doc dir, please move it to Doc/tools/static.

[skirpichev]

Look good for me, modulo Stan's comment.

I am wondering if it might be better to do this with a Sphinx object domain, though, setting the builtin things to be important

Probably, the right way might be a mixture of both.

[adqm]

Thanks! I went ahead and moved the file into tools/static and removed that comment.

[github-actions]

This PR is stale because it has been open for 30 days with no activity.