o3de / o3de.org

The O3DE website
Other
86 stars 159 forks source link

[ISSUE][DOCS] There are two different pages named "Glossary" in the docs #1844

Open LB-ArturZieba opened 2 years ago

LB-ArturZieba commented 2 years ago

Describe the issue

There are two glossaries in the documentation, and both are named the same when searching for them on the page.

Screenshot for context: GlossarySearchResults

Impacted page(s)

https://www.o3de.org/docs/user-guide/appendix/glossary/ https://www.o3de.org/docs/atom-guide/glossary/

Expected experience

Glossaries have different search names (for example "Atom Glossary", and "User Glossary").

sptramer commented 2 years ago

The problem here is that our search doesn't disambiguate between guide topics (or preface topics with a guide name of some kind). Seems like this is a bug to be handled by the website vendor related to search.

chanmosq commented 2 years ago

From the docs side, this can be fixed by renaming to O3DE Glossary and Atom Glossary. However, the main issue this points out is that the search engine should show the path, or similar information, to help users distinguish the pages that appear in the search result.

chanmosq commented 2 years ago

Needs-triage label is left on to be properly triaged by the website team