VCOI WG Wiki

• Define ‘annotations’:
  • Those items needed for Terms/Definitions, Abbreviations or References, that take the form of text rather than other data or ‘things’
• Status: we are working through an ‘Annotations Wishlist’
• Findings
  • Experiment One (spreadsheet of GovDTF initial 11 terms)
  • Later PoC work
  • Discussions
• Status:
  • To be de-duplicated and cleaned up
  • Many of the terms needed are available in FIBO AV and OMG AB SM; we will use those as a starting point

(or whatever we end up calling it)

Example:

Term origin, definition, definition adapted from etc.

Things about items in the Resource i.e. things about definition, things about acronym etc.

Stuff that is not part of the relationships among these things.

That is, this is not a complete list of things in the resource.

Like: OWL Annotation Properties as distinct from OWL Object Properties or OWL Datatype Properties.

Future work: We need to fine tune this once we have looked at the examples and edge cases in this wish list. Would this change from WG to WG? Without the clarity we just identified the need for, we don’t know yet. Ideally we want something that TFs and SIGs can easily digest.

Desired annotations for 3 things:

• 1. Terms and Definitions
  • E.g. definition origins
• 2. Abbreviations
  • Including symbols and abbreviations
• 3. References

Some of the annotations for (1) and (2) may be the same.

Separately, some of the information to be retained (2) will be cross-references to (1) or (3) but these are not strictly annotations so not included here.

Stuff we have done so far to tease out these requirements:

• GovDTF initial pilot
  • Spreadsheet: ‘Experiment One’
  • Spreadsheet with columns, some of which are the desired annotations
• Blockchain PSIG RFI: Disposable SSIDs
  • Word document: ‘Blockchain PSIG Terms and Definitions’
  • Loose text file accompanying the RFI Glossary, of additional information accompanying definitions
• Finance: FIBO Experiment
  • Spreadsheet: ‘equity processing’
  • Dealt mainly with structural features: class and property taxonomy; relations
• FIBO
  • FIBO Annotation Vocabulary RDF resource
  • OMG Specification Metadata (AM SM Namespace)
• References: Meeting notes on additional output requirements for free-form reusable information
  • Minutes: ‘20210301 VCOI Call Notes’
  • Yields some annotation requirements e.g. keywords, exhibits
  • Basic requirement for References is in the existing referencing conventions

Experiment One:

Synonym(s)

Acronym

Origin

Broader Than

Narrower Than

Relationships

• Structural not annotation

Origin

URI

• Stored definition (ISO 1087 or Sentence Case)
• Expressed definition styles
  • ISO 1087
  • Sentence case
  • Composite
    • Combines Definition + Explanatory Note (not Editorial Note)

Explanatory Note

Blockchain PSIG Terms and Definitions

Sourced Definition (Original definition at source)

Adapted Definition

Kinds of Adapted – do we need to distinguish these?

Adapted Definition – edited for grammar only

Adapted definition – cut down

Adapted From

Reasons for adaptation?

Definition Origin (see also FIBO)

Definition Origin (as URI)

Definition Origin (as publisher)

Definition origin (as Reference i.e. paper, author, publisher, date) = link to References content

Definition origin (as term in a source model e.g. message model, UML model or ontology)

• The above separate formats or kinds of origin - Same for ‘adaptedFrom’

Source URI

• As Source for Definition
• As source for Definition later Adapted
• As source for Explanatory Notes
  • Typically the source may have one definitional clause plus run-n sentences of an explanatory nature, and sometimes of a usage illustration nature

See SKOS Notes extensions and FIBO AV extensions to SKOS note

Usage Notes Synonym Syonymous form(s) - E.g cryptocurrency v crypto-currency - if a distinction is needed for this kind of syonym FIBO AV - Term Origin - Definition Origin - Adapted From Originally in a range of formats: • URI • Document • Individual term o Term name in FIBO may differ from the name in the source model for which that definition and / or that original intended concept is intended Abbreviations Experiment One Stands for Definition? / link to Terms and Definitions - Structural? Reference URI Blockchain PSIG Terms and Definitions Acronym requirements in this file Expansion information - E.g. for the acronym IA, brief explanation of ‘Identification’ and of ‘Authentication o Or this may be better served as a link o Output formats; be able to return definitions, explanatory notes at the target of that link References Experiment One Name Reference Acronym / Abbreviation - Ideally link not annotation Kind of Thing - structural – link to ontology, e.g. for the concept ‘Act’ or ‘White Paper’) Description Meeting Minutes 01 March Basic Annotations Things over and above what is retained in standard reference formats (these being a given) Reference Part - see Ontology of the Document - e.g HTML Anchor tag Exhibits • Keyword o Or Keywords • GitHub feature • MD file • Embedded graphics • Images • Documents created by authors / group • Web / wiki pages • Abstract? (not in 01 March minutes) • Kind of Resource (e.g. White Paper, Journal Paper)

Ontology of the Document (partial) First Step: ontology of the document / wiki etc. component e.g. • Term • Definition o ISO 1087 Definition o Human Definition • Origin o different kinds of origins • Reference o Author • Document Part o Section  Sub-section o Appendix o Preface o Front matter o RFI / RFP Parts  Response Instructions • Who may respond • How to respond  Summary (physical model: Section 2.1)  Details (physical model: Section 2.2) o Terms  Terms specific to this RFI  General OMG Terms o References  Standards • OMG Specifications • Other standards  Other references • OMG Document (other than standards) o White papers • White Paper • Yellow paper