• 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:

Any news and updates of general interest to CTWG members

• ACTION: Drummond Reed to get back to Scott Perry regarding next steps for developing a glossary for the Issuer Requirements Guide.
• ACTION: Drummond Reed to have an offline meeting with his Technology Stack WG co-chair Darrell O'Donnell to discuss the essential tooling needed to add glossaries to the current and upcoming TSWG specifications and report back via Slack or no later than the next meeting.
• ACTION: Drummond Reed to schedule a "Putting TEv2 To Work" meeting to discuss how we can start using the TEv2 tooling with GitHub Markdown documents for ToIP deliverables. More details in earlier report. This meeting needs to be postponed as we think through our new glossary tooling. Suggestion: check the action ONHOLD.

Henk van Cann

Harmonizing Glossaries and Semantics (TEv2)
Interesting slide of the Issuer Requirements TF -> here. It says 'Needs to be harmonized with the ToIP glossary'.  
How does this relate to TEv2 principles? Notably Semantics. Are there more assumptions we need to be aware of? 

CTWG slide notes
"adopting terms from ToIP (or terms from any other glossary to the liking of authors or groups)
write/maintain your own definition of a (new) term, deliverable specific"

Henk van Cann Brian Richter 
Rieks Joosten 

Report on what progress (if any) took place over the past 2 weeks on either TEv2 or KERISSE tooling and code bases.

• DECISION to make: should we still keep the Monday 9AM PT/17:00 UTC calls on TEv2 code development?

ALL

As Henk joins us as co-chair replacing Rieks Joosten, we are revisiting our plan for glossary management tooling.

Henk will share his thoughts first.

The following writeup from Drummond explains his proposal that grew out of screenshot #1 below.

First, to simplify the job of tech spec construction and editing, the Technology Stack WG has adopted the Spec-Up spec editing tool which is a DIF open source project. Spec-Up is currently being using by TSWG spec authros including Darrell O'Donnell (ToIP Trust Registry Protocol Specification), Drummond Reed (ToIP Technology Architecture Specification), and Lance Byrd (did:webs Method Specification) and Henk van Cann (WebofTrust kerific-spec). All of them need basic glossary management in these specs (the ToIP Technology Architecture Specification has been waiting for over a year to add a glossary).

Spec-Up already has a basic glossary feature: def tags for defining glossary entries and ref tags for marking up terms in the spec that refer to def-tagged terms. When Darrell and Drummond discussed it after the last CTWG meeting, we realized there are just two additional features we would need in Spec-Up to have “MVP” glossary management for all the specs coming out of TSWG over the next few months.

The first feature is to add Spec-Up code that detects dangling refs and defs. In other words, code that checks to see that: a) any ref tag defined in the spec has a corresponding def tag for the glossary entry, and b) every def tag defining a glossary entry has at least one ref tag pointing to it.

The second feature addresses a current limitation of Spec-Up: ref tags can only reference def tags in the same Spec-Up document. Darrell had the brilliant idea that the CTWG should begin publishing the ToIP Glossary as its own standalone Spec-Up specification, where every entry is properly formatted with a Spec-Up def tag. If we do that, then all we need for any TSWG specification to be able to include terms from the ToIP Glossary (without having to copy those 400+ terms over into its own glossary) is to enhance Spec-Up code to support remote refs.

The only difference between a local ref and a remote ref is that the former are always within the same Spec-Up document — they look like:

[[ref:term]]

The latter allow the author to reference a def in a different Spec-Up document. They look something like:

[[ref:doctag#term]]

doctag is a short unique tag assigned to the remote Spec-Up document containing the def for the term being referenced. So any Spec-Up document that uses remote refs would need to include a doctag section that looks something like this:

[[doctags:

[toip:https://trustoverip.github.org/cwtg/toip-glossary.md]

[hxwg:https://trustoverip.github.org/hxwg/hxwg-glossary.md]

]]

For example, a specification that includes a ref tag that looks like this: [[ref:toip#term]] would reference a def tag defined in the ToIP Glossary. Similarly, a ref that looks like [[ref:hxwg#term]] would reference a defined term in the (theoretical) HXWG glossary.

With this remote reference feature, all ToIP specifications (and any other deliverable written with Spec-Up) would be able to include linked glossary terms (including hover pop-up definitions) both from within its own glossary and from any referenced glossary in another document that also uses Spec-Up.

Brian Richter has estimated that he could add the necessary code to Spec-Up to support these two features within the budget remaining in the original CTWG TEv2 tooling bounty that Brian was awarded after it was approved by the ToIP Steering Committee.

The decision we need to make is whether to proceed with this new SOW.