2024-11-04 CTWG Meeting Notes

  • Meeting Date
  • : ToIP Concepts and Terminology WG Bi-Weekly Meeting  10:00-11:00 PT / 18:00-19:00 UTC. 
    See the 
    ToIP Calendar for the full schedule.

Zoom Recording

Please be informed that the CTWG Meeting of Oct 18 2024 is cancelled due to Thanksgiving.
The next one is Dec 02.

 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 announcement


ToIP Glossary V1All
 minReview of previous action items


 minSpec-Up-T

Actions Kor Dwarshuis on Spec-Up-T in the last two weeks:
- installation made simpler, no more npm install
- less information during installer script
- under the hood:
- removed redundant files
- updated packages
- fixed bug
- with logo and url (reported by Carly)
- with the alphabet index and the first term that was malformed (reported by Carly)

  • Action: Neil Thomson guinea pig's role for following the documentation. Henk contacts Neils before the next meeting.
    The first activity could be: edit https://trustoverip.github.io/spec-up-t-website/docs/intro/#real-life-example-keri-team
    The second activity could be to test the menu on a Windows machine. But the commands can be run separately on the command line.
    https://github.com/trustoverip/spec-up-t-website/blob/main/docs/general/windows-and-linux-installation.md

  • Action: Kor Dwarshuis: What needs to be installed from a "green-field" computer in which order on the regular hardware and VM infra: NPM, git, IDE, ...
    Neil wants to know how to manage a web of documents and xref to them

    Discussed, Henk urges to change

  • Action: Henk van Cann: Make instances of example roles everybody knows: ToIP, Drummond, KERI: Sam - Henk → glossary KERI Done, please comment. 

  • 1) just copy a link to a term - just with a webpage.
    2) edit a term - just with a webpage (the Github.com site)
    3) A. add a term - doesn't work just on GitHub.com webpage because of a bug. When the bug is fixed then you will be able to add it via a webpage again.
    B.  add a term - you can also have Spec-up-T installed

    You need to have it installed on your machine in order to instantiate a repository
    - Administrator Role
    - Editor Role
    - Term User Role

  • Judith Fleenor:
    I think the Glossary needs a couple of different types of training/documentation guides.
    1. For end users, just trying to look at the Glossary and use it to look up Terms. (what are all the look up functions available in the Glossary.)
    2. For end users, just trying to link to a term in their own document. (copy paste a term link.)
    3. For spec/document writers, how to reference the ToIP Glossary and how to do the markdown once the repo is setup. (#ref #xref, etc.). Term Def Recommenders, how to recommend a new Term Def.
    4. Repo Maintainers, what needs to be in place in a repo, so that #3 can be used.
    5. For organizations that want to use the tools to create their own Glossary, how to set it up in their repos to create a totally new Glossary and manage it.

  • About documentation -> we need selection based on what's relevant:
    @carly: I would like to add fronting material to this stuff - because when you get here you don't know what is relevant

  • Neil Thomson:
    The thing I'm talking about is a subject domain (e.g., Hospitality and Travel) vocabulary will/likely contain terms that are in use that are unique to their subject domain (or overlaps with ToIP/technical terms). There is also a guide for users of GDocs and Word documents that can use those links (with a longer term goal of moving to MD/GitHub). Note that in some "domains" some people will work in word drafts then throw it to another team to turn it into MD/Git/formal vocabularies

  • Postponed: We get stuck with the fact that if content writers use defs outside of the terms def directory of that ~, then <dd> is also created there and then my code is messed up because I do not yet know how to target the terms / defs. We suggest to limit: That is why we are just going to say →defs in one place
    Action: Kor Dwarshuis will solve this feature that we consider a bug in Spec-Up-T. : https://github.com/trustoverip/spec-up-t/issues/39

 min

Main ToIP Glossary

  • Postponed: How to cope with multiple/singular versions of terms, with/without dashes. etc TEv2 tooling?
    Rieks has put a proposal in Slack in the July 1 CTWG chat. Already added as a draft to the Terminology Governance Guide. We will discuss this.
    This is a "Also Known As" challenge.

  • Postponed: Revisit Carly's remarks here on Oct 7. 
    Henk's chatGPT conversation on Oct 21:
    https://chatgpt.com/share/67167941-3964-800a-9f43-6d1f16662954
2 mins
  • Review decisions/action items
  • Planning for next meeting 
Chairs

Files/Screenshots/Diagrams (numbered for reference in notes above)

#1



#2



#3





Decisions, see inline + wrap up:


Action Items, see inline