rust-docs / team

Organizing documentation work for Rust
4 stars 0 forks source link

Crazy idea: search across the entire bookshelf #13

Closed mattico closed 6 years ago

mattico commented 6 years ago

There are a lot of books on the bookshelf, and sometimes it's not obvious which one can answer your question. Googling with site:doc.rust-lang.org works okay, but Google doesn't understand versions and formatting so there's opportunity to improve. A few days ago I realized it would be "easy" to make a global search index for a bunch of MDBooks by parsing their document stores and inserting it into another index. This is the result (starting in TRPL and ending in the Nomicon):

search-demo

Code here: https://github.com/mattico/global-search The basic process:

I think this approach just needs a bit of polish to be workable. Another possibility is to use Amazon CloudSearch and have the tool run on Travis to submit changes to the index.

I'm interested in pushing this forward in my spare time, but I thought I'd ask: what do you think? Is this desirable? Is this a good approach? How could we deploy this? etc.

marioidival commented 6 years ago

Lovely

steveklabnik commented 6 years ago

This is very cool!

It'd be neat if it could say which book it was from...

fulmicoton commented 6 years ago

@mattico Awesome! Let me know if you need help with tantivy.