Algolia search suggestions lack page title

[Krinkle]

When searching on https://docs.flarum.org/, the suggestions look quite confusing. It shows the site area (e.g. parent/category) and then goes straight into an excerpt from a page.

What's missing is arguably the most relevant and important, and that's the page it is linking to.

Search: less

• Expected:
  • Extend / Themes / …
  • Extend / Updating For 1.x / …
• Actual:
  • Extend / …You can define new Less variables …
  • Extend / …Instead of directly using Less variables in CSS code…

Search: thanks for joining

• Expected: Guide / Code of Conduct / ….
• Actual: Guide / ….

This is especially confusing for results that are version-specific seaerch as release notes or upgrade guides, where you currently get taken to the middle of a page with no hint about which version it's about, unless you check the address bar or scroll bar to the top first.

[Krinkle]

In the old open source version of the Algolia doc scraper, there was an easy way to configure this in the JSON file. I don't know how that works nowadays in the proprietary version.

For jquery.com and qunitjs.com, I recently switched from Algolia to Typesense, which has been a big improvement, and is freely-licensed open source and easy to self-host (or use their cloud). I developed a lightweight frontend at https://github.com/jquery/typesense-minibar, which saved a lot on page load performance for the documentation site.

• Migrate search autocomplete from Algolia to Typesense jquery/infrastructure-puppet#33
• https://typesense.org/
• https://github.com/typesense/typesense-docsearch-scraper

Example:

• https://jquery.com/
• https://github.com/jquery/api.jquery.com/blob/v3.3.14/docsearch.config.json
• https://github.com/jquery/api.jquery.com/blob/v3.3.14/.github/workflows/typesense.yaml