Author Topic: Glossary matching options  (Read 429 times)

Uffe

  • EA User
  • **
  • Posts: 934
  • Karma: +71/-5
  • Flutes: 1; Clarinets: 1; Saxes: 5 and counting
    • View Profile
Glossary matching options
« on: March 16, 2017, 10:42:38 pm »
Hello,

Are there any options to control how glossary terms are matched in the GUI?
I've got case-insensitive and whole word only. Can this be changed somewhere?

I am aware that this wouldn't make it possible to define two terms with only casing differences. That's not the question, I want to know if I can influence what gets highlighted in the Notes fields.
(For that matter, changing how the match is highlighted from underline to a different colour or something would be nice too.)

Cheers,


/Uffe
My theories are always correct, just apply them to the right reality.

qwerty

  • EA Guru
  • *****
  • Posts: 8472
  • Karma: +123/-107
  • I'm no guru at all
    • View Profile
Re: Glossary matching options
« Reply #1 on: March 17, 2017, 08:41:48 am »
AFAIK there's nothing except sending a feature request.

q.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 5602
  • Karma: +62/-40
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Glossary matching options
« Reply #2 on: March 17, 2017, 10:55:40 am »
The whole Glossary subsystem leaves a LOT to be desired.

The underlying data structure is too simplistic, not just simplistic, but too simplistic.

Perhaps we could discuss what the requirements of a good glossary subsystem might be.

For example, we need to handle singular, plural, singural (my term for forms like: house(s) ) with the same definition.

Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Simon M

  • EA Administrator
  • EA Guru
  • *****
  • Posts: 6076
  • Karma: +43/-4
    • View Profile
Re: Glossary matching options
« Reply #3 on: March 17, 2017, 02:42:34 pm »
The underlying data structure is too simplistic, not just simplistic, but too simplistic.
Doesn't this contradict your previous assertion that the correct meaning of "simplistic" is "too simple to work properly"? Your definition is qualitative, this usage is quantitative.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 5602
  • Karma: +62/-40
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Glossary matching options
« Reply #4 on: March 17, 2017, 06:22:24 pm »
The underlying data structure is too simplistic, not just simplistic, but too simplistic.
Doesn't this contradict your previous assertion that the correct meaning of "simplistic" is "too simple to work properly"? Your definition is qualitative, this usage is quantitative.
Don't think so, I meant what I said.

The underlying model allows only for one term one definition, whereas it needs (at least many terms one definition and ideally a many-to-many relationship).

Whether you want to see it as qualitative or quantitative, the outcome is still the same - it's simplistic.

Paolo

Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

qwerty

  • EA Guru
  • *****
  • Posts: 8472
  • Karma: +123/-107
  • I'm no guru at all
    • View Profile
Re: Glossary matching options
« Reply #5 on: March 17, 2017, 08:44:53 pm »
In a past project we introduced glossary as stereotype of the profile. That opened up a whole lot of new possibilities. Of course the highlighting does not work with that. But as long as machines have no real intelligence I usually don't want those techniques (as they either highlight the wrong words or they miss others).

q.

Uffe

  • EA User
  • **
  • Posts: 934
  • Karma: +71/-5
  • Flutes: 1; Clarinets: 1; Saxes: 5 and counting
    • View Profile
Re: Glossary matching options
« Reply #6 on: March 17, 2017, 09:16:08 pm »
Perhaps we could discuss what the requirements of a good glossary subsystem might be.

Say no more!  :)

I've put some (but not an infinite amount of) thought into this before. So something like this, mebbe?
There are other areas which need some new requirements, eg HTML and doc generation, but this should be enough to get the ball rolling.

/Uffe



DEFINITIONS

Glossary entry: an entry in the glossary, consisting of a term, a type and a meaning.

Homonyms: two or more glossary entries with the same term but different type.

Reference: a glossary entry which only refers to another entry.


REQUIREMENTS -- GLOSSARY TERM MANAGEMENT

It shall be possible to store multiple glossary entries with the same term but different type.

The full definition dialog shall not be editable. Editing a term shall take place in its own dialog.
(Wishing to see the full definition of a glossary term does not imply the desire to modify it, even if the user has that permission.)

References should be represented as follows.
A pre-defined glossary type "GlossaryRef" is introduced, with special handling in the glossary entry editing functions.
A term whose type is "GlossaryRef" shall only be allowed to contain a two- or three-line meaning, where:
    the mandatory first line shall contain the name of a glossary type and nothing else;
    the mandatory second line shall contain the name of a glossary term in the specified type and nothing else;
    the optional third line shall contain a description of the reference, eg "plural of", "abbr of".
Reference descriptions shall not be preset and shall not be interpreted by the software.
(References will be able to refer to other references by specifying the GlossaryRef type in their meaning.)


REQUIREMENTS -- GLOSSARY TERM DISPLAY

For a homonym, the full definition dialog shall display all meanings for the term in full, organized by type.

For a homonym, the tooltip shall display the following:
    If space permits: all meanings for the term in full, with the respective types indicated;
    otherwise, if space permits: all meanings for the term in abbreviated form, with the respective types indicated;
    otherwise, if space permits: an indication that there are multiple meanings for the term, with the types indicated;
    otherwise: an indication that there are multiple meanings for the term.

For a reference, the tooltip shall display the meaning of the referenced entry.
If the reference has a description, the meaning shall be preceded by the description and referenced term on the form "["<reference description> <reference term>"]".
If the referenced entry is itself a reference, the meaning of its referenced entry shall be displayed instead, etc.
A circular reference chain shall result in an error message in the tooltip.
A broken reference chain shall result in an error message in the tooltip.

For a reference, the full definition dialog shall display the chain of references and the meaning of the ultimately referenced entry.

For a term, the full definition dialog shall highlight glossary terms and, on mouse hover, show the glossary tooltip. The term currently displayed in the full definition dialog shall be excepted from highlighting and tooltip in the dialog.
In other words, the highlight/tooltip function shall be the same in the full definition dialog as in other displays, except that the term being viewed shall not be highlighted.


REQUIREMENTS -- OPTIONS

The presentation of reference descriptions in glossary tooltips shall be selectable on/off.

The style of highlighting of glossary terms shall be selectable as one of:
    underlined (default);
    alternate text background colour.

The matching of glossary terms in other windows shall be selectable as one of:
    off (meaning no matching occurs, no glossary terms are highlighted and no glossary tooltips are presented);
    whole-word (default);
    substring.
My theories are always correct, just apply them to the right reality.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 5602
  • Karma: +62/-40
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Glossary matching options
« Reply #7 on: March 20, 2017, 11:05:23 am »
Thanks, Uffe!

Really good start!  I'd like to combine what you're saying with what qwerty was saying.

We already have an Onto-Terminological model that relates terms, abbreviations and concepts (as items in the repository) - and then allows direct relationships to other items in the repository.  What we'd like is the extension of the reference concept that links the "meaning" part of the glossary entry to one or more links to our "concept(s)" for that term - that is, it links back into the repository rather than duplicating meanings into the separate table.  That may have been one of your intended uses for the Glossary Reference, but I wasn't sure.

Paolo
« Last Edit: March 20, 2017, 12:07:55 pm by Paolo F Cantoni »
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Glassboy

  • EA User
  • **
  • Posts: 778
  • Karma: +47/-51
    • View Profile
Re: Glossary matching options
« Reply #8 on: March 20, 2017, 02:53:03 pm »
What about synonyms?

qwerty

  • EA Guru
  • *****
  • Posts: 8472
  • Karma: +123/-107
  • I'm no guru at all
    • View Profile
Re: Glossary matching options
« Reply #9 on: March 20, 2017, 05:47:29 pm »
Synonym -> Same Meaning

What about multi-word glossary terms? And even worse: inflections?

q.
« Last Edit: March 20, 2017, 05:57:19 pm by qwerty »

Uffe

  • EA User
  • **
  • Posts: 934
  • Karma: +71/-5
  • Flutes: 1; Clarinets: 1; Saxes: 5 and counting
    • View Profile
Re: Glossary matching options
« Reply #10 on: March 21, 2017, 08:16:50 pm »
Hello,


The intent with the specially-handled GlossaryRef type was solely to allow references between two glossary entries, not between a glossary entry and anything else. I feel that would require more substantial changes (ie a stronger integration of glossary and model), while the changes I've outlined here really only augment the existing glossary functionality. For better or worse.

Quote from: Glassboy
What about synonyms?
Synonyms would be implemented using references; if you wish you could add a description saying "synonym". The description of a reference is optional.

Quote from: qwerty
What about multi-word glossary terms?
Multi-word glossary terms are already supported, and the highlighting correctly deals with the situation where one term is a substring of another.

Quote from: qwerty
And even worse: inflections?
Inflections would also be implemented with references. I used "plural of" as an example above, here's how that would look in the glossary:
TermTypeMeaning
HospitalBuildingA big building with patients
HospitalsGlossaryRef    Building
Hospital
plural of
Sanatorium  GlossaryRef    Building
Hospital
   <-- This is a synonym entry; you could add a "synonym" line for clarity


As to making a model of the glossary, I've toyed with that a bit but never used it in anger. I had in mind to develop a profile and Add-In to work with glossary models, but it's up there on the shelf with the other Good Ideas (TM).

/U
My theories are always correct, just apply them to the right reality.

qwerty

  • EA Guru
  • *****
  • Posts: 8472
  • Karma: +123/-107
  • I'm no guru at all
    • View Profile
Re: Glossary matching options
« Reply #11 on: March 21, 2017, 08:27:43 pm »
Would be nice to see that in EA. But the Sparxians never had a strength in adopting good ideas coming from outside :-/

q.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 5602
  • Karma: +62/-40
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Glossary matching options
« Reply #12 on: March 22, 2017, 10:29:15 am »
Would be nice to see that in EA. But the Sparxians never had a strength in adopting good ideas coming from outside :-/

q.
I think it was Proctor & Gamble who famously went from "not invented here" to "proudly found elsewhere"  (sometimes also described as PIE - Proudly Invented Elsewhere)

Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Simon M

  • EA Administrator
  • EA Guru
  • *****
  • Posts: 6076
  • Karma: +43/-4
    • View Profile
Re: Glossary matching options
« Reply #13 on: March 22, 2017, 10:45:44 am »
The limiting factor for extending the built-in glossary functions is really the database structure in place.

Even with that, I think it makes a lot more sense to model your glossary than to use our glossary list. I would encourage you to implement your ideas as a profile. The management of it is then integrated with all the rest of EA functions (eg. version control, searching, reporting) you get traceability between terms etc.

Once you have that in place I see potential for an add-in to help manage a profile glossary. I can also imagine automation/scripting broadcasts to determine what should be highlighted, how to display a tooltip etc. A flexible solution like that is going to serve the needs of the community much better than any predefined glossary structure defined here.