glossarist / glossarist-ruby

Concept modeller in Ruby
BSD 2-Clause "Simplified" License
1 stars 1 forks source link

updated the yaml format #62

Closed HassanAkbar closed 1 year ago

HassanAkbar commented 1 year ago

Updated the yaml format for abbreviation

ronaldtse commented 1 year ago

@HassanAkbar there is a subtlety here.

There are a few kinds of "abbreviations" ("Abbreviated term resulting from the omission of some of its letters.").

See this: https://www.iso.org/obp/ui/#iso:std:iso:4:ed-3:v1:en

These are the kinds:

This is why an "abbreviation" has several types.

HassanAkbar commented 1 year ago

@ronaldtse We have all of these types in glossarist here (https://github.com/glossarist/glossarist-ruby/blob/main/config.yml#L47-L51), so we can set the type to abbreviation and set if it is an acronym or initialism etc like

- type: abbreviation
  initialism: true
  designation: something

OR

- type: abbreviation
  truncation: true
  designation: something

and for others we can leave it just to

- type: abbreviation
  designation: something
ronaldtse commented 1 year ago

Got it @HassanAkbar , thank you for the explanation. Can you add some documentation for the YAML format? I think we should really use YAML Schema to describe the Glossarist YAML format.

HassanAkbar commented 1 year ago

@ronaldtse Sure, I'll update the documentation after the iso-10303-2 task. I've created and issue for that here https://github.com/glossarist/glossarist-ruby/issues/65