coreos / fedora-coreos-docs

Documentation for Fedora CoreOS
https://docs.fedoraproject.org/en-US/fedora-coreos/
Other
50 stars 122 forks source link

FCOS docs discoverability: add metadata to pages #271

Open JaimeMagiera opened 3 years ago

JaimeMagiera commented 3 years ago

As discussed during the meeting of 2021-03-31, lack of metadata and search functionality has hindered documentation usage, and complicated design and placement decisions.

Moving forward, it would be helpful to incorporate search into the site (e.g. Google) and incorporate metadata into each page that accurately reflects the topics therein.

dustymabe commented 2 years ago

at least the search part of this seems to be taken care of now with https://pagure.io/fedora-docs/docs-fp-o/c/4b7021833da64fd651feffeaf6de1401a89531b0?branch=prod

I see a search box in the top right. It's not google search, but we got it for free!

@JaimeMagiera - do we want to leave this open for the metadata bits?

travier commented 2 years ago

Awesome! Yes, I think we should still add some metadata to pages to potentially improve indexations on search engines.

jlebon commented 2 years ago

I see a search box in the top right. It's not google search, but we got it for free!

Neat! Though it seems to be crawling all of docs.fp.o instead of just the FCOS docs pages, which isn't ideal.