Skip to content

WIP: Guide navigation / Guides by category / alternative search - #2900

Draft
marko-bekhta wants to merge 4 commits into
quarkusio:mainfrom
marko-bekhta:feat/grouped-search-and-improved-navigation
Draft

WIP: Guide navigation / Guides by category / alternative search#2900
marko-bekhta wants to merge 4 commits into
quarkusio:mainfrom
marko-bekhta:feat/grouped-search-and-improved-navigation

Conversation

@marko-bekhta

Copy link
Copy Markdown
Member

This is built on top of what @gsmet already had in

Opening it mostly so that people could click around and see where things are so far 🫣 🙂

Since the all guides view is slightly tied to the search, it actually has to continue relying on those components built in the search service and even use new ones for the category navigation (on the all guides page).

What else is in here:

  • updated guide cards and layout of the Guides page (only main version)
  • new way of searching
  • updated guide page
    • toc is now on the left
    • there's a "drawer" button on the veeeeeeery left that shows the list of all guides.
  • there's a new config for dev -- only main/latest guides and no --force_polling since that one just kills CPU
  • (ah and yeah -- switch to a staging env where corresponding search updates are currently deployed)
  • (dark mode is not adjusted, no new var alternativbes there yet)
  • probably something else I forgot about 🙂

things I am not super happy about:

  • building a json "on the page" to pass to the components (need the info about categories to build the categories view + search results)

inital:
image
search results:
image
Guide:
image
image

gsmet and others added 4 commits August 7, 2026 18:35
This is definitely not final and will require some discussions with
James and some iterations but it allows showing a bit what would be
possible with this new category index.

I haven't adjusted the search at all and also the appearance of the
guides is coming from search.quarkus.io and I haven't tweaked it.
I would favor a layout that is a bit more compact, ideally, but that's
something to tweak later.

# Conflicts:
#	_data/versioned/main/index/categories.yaml
@marko-bekhta
marko-bekhta force-pushed the feat/grouped-search-and-improved-navigation branch from 408e5f2 to 5360dbe Compare August 7, 2026 20:30
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown

🎊 PR Preview 1646c32 has been successfully built and deployed to https://quarkus-website-pr-2900-preview.surge.sh

  • Images of blog posts older than 3 months are not available.
  • Newsletters older than 3 months are not available.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants