#211 Fedora Docs- New feature- Easier Navigation
Opened by advika. Modified
fedora-docs/ advika/docs-fp-o prod  into  master

Download 211.patch

While trying to understand the hierarchy, I understood there are various categories (for eg, emerging editions). As a newcomer , It was confusing . Hence I came up with tags, that we could put up with each heading as shown in the link below :-

https://miro.com/app/board/o9J_lkoizq8=/?moveToWidget=3458764523446658801&cot=14

Tags. Each component can have tags that are suitable for them. By clicking these tags, all the components having the same tag would be visible to them. The users can also search using tags. Usage of tags also helps keep the UI clean and enhances usability.

I really like the idea of using tags. I agree that could be a big improvement for users. That said, I have two concerns:

  1. In my experience, tags require careful attention and active curation. Otherwise you end up with several tags that should be one. For example, "print", "printing", and "printers". So using this would require careful editing and probably a regular tag cleanup effort.
  2. (And perhaps more importantly) I don't know that Antora supports tags in this sense. A quick search only shows support for git tags, which is not what we want. @darknao, do you know?

I really like the idea of using tags. I agree that could be a big improvement for users. That said, I have two concerns:

  1. In my experience, tags require careful attention and active curation. Otherwise you end up with several tags that should be one. For example, "print", "printing", and "printers". So using this would require careful editing and probably a regular tag cleanup effort.
  2. (And perhaps more importantly) I don't know that Antora supports tags in this sense. A quick search only shows support for git tags, which is not what we want. @darknao, do you know?

@bcotton I do have a solution for the first point you have raised. Interestingly, Reddit has a very careful and a handful selection of tags already available. Users for now can only select from tags that reddit gives you. Perhaps even we can only support a handful of tags, and the users only choose from those tags. So now, the user can only choose tags from a selection that we have created .That would eliminate the need for a regular tag cleanup, or perhaps even curation.
Now, if someone wants to contribute to the page and thinks a tag does/doesn't belong to the tag, perhaps they can send a request for it?

As for the second issue, I am aware of that concern and trying to find a way for the final coding also. I am currently looking up on the issue.

Users for now can only select from tags that reddit gives you. Perhaps even we can only support a handful of tags, and the users only choose from those tags.

That seems like a good approach if we can enforce those limits somehow.

Metadata