I saw myself squinting a bit while I was trying to use the search navigator.

The fact that is now in our control, I made a simple PR to highlight the
search navigator text better: https://github.com/apache/airflow/pull/59703

Thanks & Regards,
Amogh Desai


On Mon, Dec 22, 2025 at 11:34 AM Amogh Desai <[email protected]> wrote:

> Nice holiday gift, Kaxil. Sphinx search was a bit annoying and this one
> seems promising!
>
> Took it out for a spin and I really like how it feels now with the dark
> mode as well.
>
> Thanks & Regards,
> Amogh Desai
>
>
> On Sat, Dec 20, 2025 at 10:33 PM Jarek Potiuk <[email protected]> wrote:
>
>> All refreshed. Just Shift-R the page in case you have problems.
>>
>> On Sat, Dec 20, 2025 at 4:43 PM Kaxil Naik <[email protected]> wrote:
>>
>> > For folks seeing old button (different from screenshot in the PR
>> comment),
>> > give it a few hours for cache.
>> >
>> > Jarek has triggered Cloundfront cache invalidation so shouldn’t be too
>> long
>> > before you see the changes.
>> >
>> > On Sat, 20 Dec 2025 at 15:30, Kaxil Naik <[email protected]> wrote:
>> >
>> > > This wasn’t critical so didn’t invalidate cloudfront cache since it
>> will
>> > > propagate anyway eventually. But s3 is synced.
>> > >
>> > > On Sat, 20 Dec 2025 at 15:02, Jarek Potiuk <[email protected]> wrote:
>> > >
>> > >> Strange thing - I do not see it yet
>> > >>
>> > >>
>> >
>> https://github.com/apache/airflow-site-archive/actions/workflows/github-to-s3.yml
>> > >> -> has not been run. And this one is needed (even if you manually
>> sync
>> > S3,
>> > >> you also need to invalidate cloudfront cache after you sync stuff to
>> S3.
>> > >>
>> > >> On Sat, Dec 20, 2025 at 3:20 PM Kaxil Naik <[email protected]>
>> wrote:
>> > >>
>> > >> > Thank you Phani & Jarek. PR is merged and this has now been
>> deployed
>> > to
>> > >> our
>> > >> > Prod site for 3.1.5 and stable html docs.
>> > >> >
>> > >> >
>> > >> > On Sat, 20 Dec 2025 at 08:44, Phani Kumar via dev <
>> > >> [email protected]>
>> > >> > wrote:
>> > >> >
>> > >> > > This is amazing. Great work Kaxil !
>> > >> > >
>> > >> > > On Sat, Dec 20, 2025 at 1:23 PM Jarek Potiuk <[email protected]>
>> > >> wrote:
>> > >> > >
>> > >> > > > Very nice and slick. Did my review :) .. looks great and it's
>> > nice.
>> > >> > > > One small comment I would even say we should leave it as the
>> only
>> > >> > option.
>> > >> > > > It feels weird to have two different ways of searching :)
>> > >> > > >
>> > >> > > > On Sat, Dec 20, 2025 at 2:07 AM Kaxil Naik <
>> [email protected]>
>> > >> > wrote:
>> > >> > > >
>> > >> > > > > Hey all,
>> > >> > > > >
>> > >> > > > > tl;dr: Visit
>> > >> > > > https://airflow.staged.apache.org/docs/apache-airflow/3.1.5/,
>> > >> > > > > press Cmd+K (or Ctrl+K), and try the new search experience.
>> > >> > > > >
>> > >> > > > > Now details :D
>> > >> > > > >
>> > >> > > > > After implementing dark mode to solve one of my frustrations
>> > >> > > > > and modernizing deps on airflow-site, I went on the journey
>> to
>> > >> > improve
>> > >> > > > > (have an alternate) search experience on Airflow docs. I
>> really
>> > >> hate
>> > >> > > the
>> > >> > > > > Sphinx search -- it is slow and often returns irrelevant
>> > results.
>> > >> > > > >
>> > >> > > > > Similar GH issue created 3 years ago:
>> > >> > > > > https://github.com/apache/airflow-site/issues/666
>> > >> > > > >
>> > >> > > > > I am happy to share that
>> > >> > https://github.com/apache/airflow/pull/59658
>> > >> > > > > introduces a modern, fast, client-side search powered by
>> > Pagefind
>> > >> (
>> > >> > > > > https://pagefind.app/).
>> > >> > > > >
>> > >> > > > > Preview is available on our staging site:
>> > >> > > > > https://airflow.staged.apache.org/docs/apache-airflow/3.1.5/
>> > >> > > > >
>> > >> > > > > Visit it, and press cmd+K and try it out.
>> > >> > > > >
>> > >> > > > > Key improvements:
>> > >> > > > >
>> > >> > > > >    - Instant search: Results appear as you type with no
>> server
>> > >> > > > round-trips
>> > >> > > > >    - Better relevance: Better title matches rank
>> > >> > > > >    - Cleaner results: Auto-generated API docs and internal
>> pages
>> > >> are
>> > >> > > > >    excluded
>> > >> > > > >    - Keyboard navigation: Full keyboard support with
>> > Cmd+K/Ctrl+K
>> > >> > > > shortcut
>> > >> > > > >    - Modern UI: Custom-built modal with our own CSS/JS
>> > >> > > > >    - Privacy-friendly: All search happens client-side, no
>> > external
>> > >> > > > services
>> > >> > > > >
>> > >> > > > > The PR is ready for review. Once merged, I'll deploy it to
>> > >> > production.
>> > >> > > > > Documentation for the Sphinx extension is included in the PR.
>> > >> > > > >
>> > >> > > > > I'd appreciate feedback and reviews! After spending
>> considerable
>> > >> time
>> > >> > > on
>> > >> > > > > the JS, CSS, and search tuning, I'm confident this will
>> > >> significantly
>> > >> > > > > improve our users' documentation experience.
>> > >> > > > >
>> > >> > > > > Happy Holidays. 🎄
>> > >> > > > >
>> > >> > > > > Regards,
>> > >> > > > > Kaxil
>> > >> > > > >
>> > >> > > >
>> > >> > >
>> > >> >
>> > >>
>> > >
>> >
>>
>

Reply via email to