Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Handling multiple concept fields/planes/domains #621

Open
ronaldtse opened this issue Apr 13, 2022 · 1 comment
Open

Handling multiple concept fields/planes/domains #621

ronaldtse opened this issue Apr 13, 2022 · 1 comment
Labels
enhancement New feature or request

Comments

@ronaldtse
Copy link
Contributor

As discussed with @opoudjis , this work integrates a few components we already have.

Use case: I want to have a concept dictionary that is composed of multiple concept fields, represented in Metanorma. This need is already shown in ISO 10303-2.

ISO 10303-2 contains:

  • normal Clause 3 terms in clause 3
  • EXPRESS application integration modules in clause 4
  • EXPRESS module-integration modules in clause 5

Example term from clause 3 (general ISO concept):
image

Example term from clause 4 (EXPRESS concept):
image

These 3 types of concepts technically belong to different "concept fields" / "concept planes" / "concept domains". And the individual concepts can be related, e.g. a concept in clause 4 can be the implementation of an English concept in clause 3.

The representations of a Clause 3 term and an EXPRESS entity concept would also likely be different, as the data structures are different.

Notice that for ISO terms, we explicitly or implicitly define:

  • Data structure: ISO 10241-1, etc.
  • Input syntax: as in the concept AsciiDoc input syntax used by Metanorma
  • Presentation: as defined in ISO 10241-1 / ISO DIR 2 and implemented in metanorma-iso

Basically, we want to achieve this:

  • Allow the author to define a data structure using a data specification language (a schema)
  • Allow the author to define the input syntax (based on the data specification)
  • Allow the author to specify a presentation template, e.g. as in Annotated EXPRESS, a Liquid-enabled Metanorma AsciIDoc template.

In order to extend this functionality to other concept fields/planes/domains, we can:

  • For the data specification language, we use LutaML
  • For the input syntax, define using LutaML
  • For the presentation, use the LutaML output block

Then in order to render non-ISO concepts, it would be simply to enumerate them from some external YAML file.

@ronaldtse ronaldtse added the enhancement New feature or request label Apr 13, 2022
@ronaldtse ronaldtse moved this to Triage in Metanorma Apr 13, 2022
@opoudjis opoudjis moved this from Triage to High priority in Metanorma Apr 17, 2022
@opoudjis opoudjis moved this from 🏔 High priority to 🏗 In progress in Metanorma Nov 15, 2023
@opoudjis
Copy link
Contributor

opoudjis commented Nov 18, 2023

@ronaldtse I have no idea what you are asking for, and absolutely none of this:

Allow the author to define a data structure using a data specification language (a schema)
Allow the author to define the input syntax (based on the data specification)
Allow the author to specify a presentation template, e.g. as in Annotated EXPRESS, a Liquid-enabled Metanorma AsciIDoc template.

is any responsibility of mine at all. Neither is Lutaml. I am unassigning myself this ticket.

I don't know what we discussed 18 months ago, @ronaldtse, but that doesn't change the fact that I can't action this.

@opoudjis opoudjis removed their assignment Nov 18, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
Status: 🏗 In progress
Development

No branches or pull requests

2 participants