Glossary term replacement within page
backlog
David Gregory
Currently, the exact term used within the glossary is shown on the page. This doesn't look that great when different capitalization, plurals, or tenses are used in the text that the glossary term is used within.
A simple example would be to have a glossary entry called "Canada Goose" which might get used in different scenarios. In many places, the term should not be capitalized for the word "Goose". In places where they are talking about a flock of "Canada geese" this would also need to be altered. Having a replacement text available as the glossary is used would be desirable.
Log In
A
Auri Poso
To add an implementation suggestion, a glossary term "title" should not replace the text in the article but the text should instead be a link to the glossary term that on hover returns the content of the term description.
S
Sigurður Sigurðsson
There's another thing to consider here: Multiple languages (especially Slavic ones) decline words based on context. Icelandic nouns are declined by case, gender, number and definiteness, so there's no reasonable way to pre-emptively cover them all.
For example if I wanted to include a glossary term for a hat in Icelandic, I'd use the nominative "Hattur" as my glossary term. Definite articles in Icelandic are added as a suffix to the noun, so if I wanted to write something like "You can wear
the
hat", I'd have to use "hattinn" instead. Instead, I'd like to suggest that you just allow me to type in an alternate display word for my glossary link within the page, much like you already do with URLs and links to other articles. So, glossary insert for my previous example would look something like "{{Glossary.Hattur|hattinn}}". It seems much simpler to implement than pre-defined synonyms and would cover pretty much any use-case I can think of.
Barbara Dreyer
I agree and there is no say to revise content to fit glossary limitations. Looking forward to an enhancement from Doc360.
D
D360 Product Management
Merged in a post:
Allow synonyms in glossary
Katherine Armstrong
Customers sometimes use different words for items we document - we'd like the ability to include a synonym or 'also known as' capability in a glossary definition, that we could then link to the 'proper' term, instead of maintaining two definitions.
D
D360 Product Management
backlog
D
D360 Product Management
David Gregory would like to understand little more on the use case shared, 'Canadian Goose'. The understanding is if the user is provisioned with
(a) an option to rename the Glossary term with formatting options such as display in uppercase / lowercase the term in both areas, i.e within Editor ( glossary.GOOSE) and KB site, then your requirement would be fulfilled.
(b) just like image provide an alias / alternative name for the glossary term should be fine as well.
Can you kindly share your thoughts to ensure, we are on the same page of understanding ?
David Gregory
D360 Product Management: There are a number of ways that you could solve this problem.
The most generic alternative would be to allow multiple textual alternatives that can be entered encompassing the alternatives that are required (Canada Goose, Canadian Geese, Canadian geese, etc.). Then when using the glossary term you would have to be able to select which version of this would be used.
A less complete alternative would be to provide alternative terms for different situations (singular, plural, etc.) When using the glossary term, you should be able to select which situation and which capitalization (Sentence case, lower case, UPPER CASE, Title Case, etc.) you wish to use during the display.
D
D360 Product Management
David Gregory: Thanks for sharing the details. We will have this evaluated and keep you posted about the updates in future. I look forward to provide alias names for "term" value rather multiple contextual definitions. However, we will make a thorough investigation before we decide on a approach.
Appreciate your time, effort and understaning.
Mohamed Shakheen
Mohamed Shakheen
Mohamed Shakheen
Hi Hannah
Thank you for your valuable feedback. We consider this as an enhancement under the glossary feature and we will share the update here.
David Gregory
It is important that when either a glossary entry or synonym is searched for then pages which use the glossary entry should be displayed in the result.
Load More
→