Decisions on LinkML and documentation 2022-09-20

ramonawalls commented 2 years ago

After much discussion, we will:

Keep the name, title, and ID fields.

linkml name = structured comment name

linkml title = item

linkml ID = term IRI (but can display in the form of a CURIE like MIXS:0001234

ramonawalls commented 2 years ago

Changes to documentation display pages that were discussed:

[] on xx, checklists before packages TODO: finish this

@only1chunts did you make notes one what needs to be changed in the documentation display?

turbomam commented 2 years ago

names, titles and IDs

The LinkML derived from schemsheets that use the MIxS terms verbatim as names fail when used in various data-conversion, schema-conversion and data-validation steps. I have retained the MIxS names as annotations but have applied systematic names for all terms/slots (snake_case) and all checklist/package classes (PascalCase)

Checklists should be listed before packages on the index page
names and IDs of combination classes should follow the pattern {checklistportion){package_portion}