Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 5 Next »

  • 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 Link / 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 announcements

ToIP Glossary V1All

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 I agreed with 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 date and time. → Issue Time-travel

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 date-time stamp, i.e., it is a 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. Not sure whether this point perseveres.
  • 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 specifically xrefs; refs to def within one terminology repo have to be kept in sync with the concepts in the specification by hand.
1 minReview of previous action items

A. Concerning 2. and 3.: There was a question of Brian whether we'd prefer to use glossary.trustoverip.org rather than trustoverip.github.io/glossary and onwards glossary.trustoverip.org/#term:acdc for the permanent links to the latest version of that term definition (example 'acdc').
B. Note: currently, we use https://trustoverip.github.io/ctwg-main-glossary/#term:acdc . We'll try to redirect this URL to the URL chosen under A.

Slack discussion
@DrummondReed: Elevating our glossary to the DNS subdomain level would — I believe — give us the best chance at long-lived links (because that link doesn’t rely on github). If you and other CTWG members agree, then my vote would be for glossary.trustoverip.org/#term:name. What does everyone think?
@EricScouten: I'm a big fan of this approach. Own your own data, my friends!
@HenkvanCann: I am a proponent of glossary.trustoverip.org/#term:name if it's doable.
@DrummondReed:What do we need to do (technically) to “make it so”? Also, in addition to http://glossary.trustoverip.org/#term:name, it would IMHO be ideal if http://glossary.trustoverip.org/#name worked as well. I believe the latter could just link to the heading for the term (if all headings were automatically bookmarks, which I believe is how Spec-Up works).

@HenkvanCann: This is the question I asked @Brian Richter
. I think that http://glossary.trustoverip.org/#name can cause ambiguity with a "normal" header with the same name as a term. But I am not sure. We have to delve into this.

RESCHEDULE 

15 minSpec-Up-T
  • Do we have a standard procedure for:
  • Proposing edits to existing terms in the ToIP Glossary?
    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.
  • Proposing new terms to be included in the ToIP Glossary? Same, PRs or directly when user right sufficient (with great power comes great responsibility)
  • Never delete a term definition, just revoke the definition and forward to new terms that cover the concept. How? Edit the term, including an optional link
  • Discuss what steps remain to publish an official ToIP Glossary V1 specification by the end of August
    The remaining issues in Issues here: https://github.com/blockchainbird/spec-up-t/issues. August is too enthusiastic. Let's try to make IIW autumn 2024.
    Note: the home of Spec-Up-T might become trustoverip or DIF. Temporarily at Blockchainbird.org.

    ACTION: Henk and Kor need a Spec-Up-T repo at trustoverip


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 minSpec-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

2 mins
  • Review decisions/action items
  • Planning for next meeting 
Chairs

Screenshots/Diagrams (numbered for reference in notes above)

#1 



#2



#3





Decisions


Action Items




  • No labels