2024-11-04 CTWG Meeting Notes
Meeting Date
Nov 4, 2024 : 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
@Judith Fleenor
@Henk van Cann
@Drummond Reed
Agenda Items and Notes (including all relevant links)
Time | Agenda Item | Lead | Notes |
3 min |
| Chairs |
|
5 min | General announcement | ||
ToIP Glossary V1 | All | The direct working connection between LFDT (Ben) and @Kor Dwarshuis to be able to do something with the subdomain. Judith has send an e-mail to Ben during the meeting. | |
min | Review of previous action items | ||
min | Spec-Up-T | @Henk van Cann | Actions @Kor Dwarshuis on Spec-Up-T in the last two weeks: 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. @Carly Huitema / @Henk van Cann -> Levels: 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 | @Rieks Joosten @Henk van Cann | 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 |
| Chairs |
Files/Screenshots/Diagrams (numbered for reference in notes above)
#1
#2
#3