New Search System for Godot Docs is Terrible :(

Wow, dang i actually thought i was the only person who disliked the search feature in the docs. Otherwise they are genuinely really helpful to me. *Most of the time
*Glad there’s dark search, much better

I hope OP or someone can mark this line the solution! HERO!

1 Like

Can’t mark solutions in General.

1 Like

This thread went a lot of places I wasn’t expecting… though I can at least explain my two-fold reason for preferring to use the document lookup on the website over that in the Godot Engine itself.

Firstly, I find the documentation lookup in Godot Engine to be trickier to use than that of the web interface, compounded by my having to click away from whatever script file I am working on and then having to find my way back to where I was following. Being able to instantly, in just one click, go back and forth between the documentation and the script I am writing is essential and easier to perform if the documentation is open in a separate program altogether, such as my web browser.

The second reason is that I prefer to read documentation as black text on white, whereas I prefer to code as white text on black. Having that distinction creates a stronger mental kick between learning and applying, if that makes any sense… It’s just easier for me to multi-task in that manner by having a visible distinction between actually coding and reading the docs and I’m not sure how to easily set up such a difference in the Godot Editor itself, which makes it easier to just switch between the editor and a web browser window with a single click.

When “Read the Docs” updated their search system for the worse, I wasn’t sure who to inform, so my hope with this post was to get my complaints in front of someone running things behind the scenes for the Godot Foundation to actually forward my grievances to Read the Docs. Whether that’s happened or not, I dunno, I just know it’s been over two months now and the search feature in the documentation here on the Godot Engine website is still worse than it was prior. :confused:

Has anyone tried downloading the docs locally? All the download links seem broken?

Yes they are currently broken but there’s already a PR and once that is in it should be good again.
But there’s also a link to what I think is the last good one, you just gotta click that “Check on Github” link
https://nightly.link/godotengine/godot-docs/workflows/build_offline_docs/master/godot-docs-html-master.zip

1 Like

Thank you. I had a friend trying to get them yesterday and couldn’t.

While browsing the forum I like to check the docs without opening Godot.
Today I wanted to go to this page. It describes the OBJECT class. I was looking for the definitions of queue_free() and free().
Typing in “queue_free” returns a lot of results but none of them are that page; the actual definition of the function.
The old search does find the OBJECT page.

I think this new search is in dire need of improvement. If the solution is “open Godot and use F1” then there is no point in having online docs.
I would recommend an improvement proposal.

3 Likes