website icon indicating copy to clipboard operation
website copied to clipboard

Can't find Flux FAQ from fluxcd.io easily

Open mewzherder opened this issue 2 years ago • 3 comments

Hi! I was on fluxcd.io and had heard of Flux FAQs. I couldn't find them until I was digging around in the docs. Is there a way that we can make it easier to find from fluxcd.io ? I searched "faq: in the fluxcd.io search bar and it only showed me the flagger faq link (which is good). I hope my question makes sense. thanks!

mewzherder avatar Sep 08 '22 14:09 mewzherder

There are definitely still some issues with the search, I see what you're saying, here's the FAQ search result:

Screen Shot 2022-09-08 at 12 24 11 PM

There are three flagger results and two Flux results, but none of them are targeting the proper Flux FAQ page itself (two go towards the migration docs, and three flagger docs links, all of them are pages with the word "FAQ" visible somewhere on it)

I opened #1138 to try to address the fact that the main FAQ page does not even rank when you search for FAQ. We shouldn't have to duplicate the title in the description to get this to work, maybe a bug in the search provider.

Maybe worth it to try to squeeze another entry on the top bar for the FAQ, around here -WDYT? :

Screen Shot 2022-09-08 at 12 38 20 PM

kingdonb avatar Sep 08 '22 16:09 kingdonb

I’m not for adding more things to the top menu, it’s cluttered already.

stefanprodan avatar Sep 08 '22 17:09 stefanprodan

This could be fixed by #1185 and #1188

dholbach avatar Oct 12 '22 08:10 dholbach