Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  • Meeting Date
  • : ToIP Concepts and Terminology WG Bi-Weekly Meeting  10:00-11:00 PT / 17:00-18:00 UTC. 
    See the 
    ToIP Calendar for the full schedule.

Zoom Meeting

...

Recording

Attendees

Agenda Items and Notes (including all relevant links)

TimeAgenda ItemLeadNotes
3 min
  • Start recording
  • Welcome & antitrust notice
  • Introduction of new members
  • Agenda review
Chairs
  • Antitrust Policy Notice: Attendees are reminded to adhere to the meeting agenda and not participate in activities prohibited under antitrust and competition laws. Only members of ToIP who have signed the necessary agreements are permitted to participate in this activity beyond an observer role.
  • New Members: 
5 minGeneral announcementsAll

Judith Fleenor wanted to make sure that everyone was aware that the ToIP Foundation will be moving under the LF Decentralized Trust umbrella. This will involved updates to some of our tooling, including moving to Discord. All of this will be coming down the pike over the next two months.

Kyle Robinson said that BC Gov has a new Digital Trust Toolkit | Digital Trust Toolkit (bcgov.github.io)

Drummond Reed is that the Governance Stack Working Group is going to be focused this fall on developing a V2 of the ToIP Governance Architecture Specification and ToIP Governance Metamodel Specification and Companion Guide. The very first step is to add support for the ToIP Glossary. 

Drummond Reed said __________.

Henk van Cann said that this Friday Aug 30 at 14:00 CEST there will be a presentation of the Spec-Up-T tools for the DIDAS group. Henk will share the Teams link when he has it.


ToIP Glossary V1All

Kyle asked what we should do with the previous ToIP Glossary. 

We discussed that some parties have been referencing the previous version of the ToIP Glossary here: https://trustoverip.github.io/toip/glossary.

Henk van Cann suggested that we put a large banner at the top of the previous ToIP Glossary.

Kor Dwarshuis has already create a PR to do this.

We then discussed the question of whether any "retrofitting" of the old ToIP Glossary is needed.

Drummond Reed said that, with the new ToIP Glossary, authors can make a time-delimited external reference (x-ref) to any term—or to the ToIP Glossary as a whole. That will effectively "freeze" the glossary for the author.

Kyle Robinson asked if there was a way to reference a specific "version" of the ToIP Glossary as of a specific point in time (and not just to specific definitions within the ToIP Glossary at that point in time). He shared this link as an example: Tenure and Resource Stewardship Branch Governance Framework | Digital Trust Toolkit (bcgov.github.io)

Neil Thomson gave the example of being able to look at the whole set of definitions that are present in the ToIP Glossary at a point in time.

Henk van Cann was agreeing in this functionality, as it would be a "game changer" because it would enable a specification or other document to fully externally reference those definitions in the ToIP Glossary as of that specific datetime.

ACTION: Henk van Cann and Kor Dwarshuis to propose a design for this functionality to be able to reference a term—or an entire version of the ToIP Glossary—by a date, such that all glossary items have at most that date in their GitHub datetime stamp, i.e., it is an historical lookup. They will also look at the option of creating periodic versions as "snapshots" of the ToIP Glossary (as HTML and/or PDF) with their own URLs.

Kor Dwarshuis pointed out that the GitHub API can throttle requests if there are too many filtering requests.

Neil Thomson brought up the option of taking snapshots of the ToIP Glossary for "official major releases" periodically, such as quarterly. Kor agreed that such snapshots could be "frozen snapshots". 

Judith Fleenor "I always thought that was in the design.  But that was before we went to spec up.  The author of a document, when they make a ref to a def need to know that def will not change later." Henk van Cann clarified that this will be true for specific xrefs.

1 minReview of previous action items
  •  CNAME configuration is possible, see more at chatGPT
1 minReview of previous action items
  •  Spec-Up-T, The Diff tool in the example in the main ToIP gloss, didn't work. So we'd like to demonstrate AAL today. 
15 minSpec-Up-T

ACTION: Henk van Cann and Kor Dwarshuis to study and make a final recommendation.

RESCHEDULE 

15 minSpec-Up-T
  •   Discuss the status of the permalink proposal.
    The SpecUp versioning creates copies; not desirable. The latest version of the term is the permalink. With an Xref the commithash of the time of referencing is available. There should be a checkbox available what you'd like to see: latest or commit# at the time of reference.
     Do we have a standard procedure for:
  1. Proposing edits to existing terms in the ToIP Glossary?
    1. Proposing new terms to be included in the ToIP Glossary?
      1. Discuss what steps remain to publish an official ToIP Glossary V1 specification by the end of August.
        Discussion: what's the realistic time frame for this:
      Carly Huitema : It would be cool if we could give each term a SAID. Perform a hash of the definition sentences, and then it could also be referenced by its SAID (and verified).

      To get a SAID you need: Canonicalization, Serialization, SAID calculation

      Long discussion; Kent Bull offered to write a blog post with a step-by-step, Carly Huitema offered to test.
    10 min

    Term Version management and Diff tooling.

      1. This can be done by creating a PR. If the author has admin rights to the repo, it will make the edit directly. Otherwise it will take the author to a PR that can be curated by a maintainer.
      2. Kor Dwarshuis showed an example.
    1. Proposing new terms to be included in the ToIP Glossary?

    2. Never
     How to recover from source deletion?
    Answer: we keep a local copy of Xref'ed term definitions just in case the sources we don't control are deleted.
    Sources we do control: never
    1. delete a term definition, just revoke the definition and forward to new terms that cover the concept. How?
    •  Discuss what steps remain to publish an official ToIP Glossary V1 specification by the end of August


    15 min

    Main ToIP Glossary

    •  How to cope with multiple / singular versions of terms, with/without dashes. etc TEv2 tooling?
      Rieks has put a proposal in Slack July 1 CTWG chat. Already added in draft to Terminology Governance Guide. We will discuss this.
     5 minTerminology Governance Spec-Up-T User Guide

    Spec-Up-T User Guide


    RESCHEDULE:

    Every meeting a new aspect to discuss and decide upon. https://trustoverip.github.io/ctwg-terminology-governance-guide/

    ? minSpec-Up Use

    Spec-Up tips & tricks As we have many specifications in flight I have been compiling some SpecUp tips & tricks

    •  ACTION: Coordinate with Darrell O'Donnell on a "cheat sheet" for Spec-Up with input from Drummond Reed and Neil Thomson
    •  ACTION: Drummond Reed to start the Spec-Up conversion process for the ToIP Technology Architecture Specification and record any key questions or issues.
    2 mins
    • Review decisions/action items
    • Planning for next meeting 
    Chairs

    ...