2021-01-04 CTWG Meeting Notes

Meeting Date

04 Jan 2021

Attendees

Main Goal of this Meeting:

To discuss the remaining steps necessary to putting the end-to-end CTWG workflow process in place.

Agenda

Time	Item	Lead	Notes
1 min	Welcome & Antitrust Policy Notice	Chairs
2 mins	Introduction of new members	Chairs
1 min	Agenda review	Chairs
10 mins	Using the Decentralized Governance white paper as a test of the hyperlinking pop-up proposal Discuss Terminology Engine V2 (TEV2) being developed at eSSIF-Lab by GRNET	Rieks Joosten Drummond Reed
20 mins	Review of URL / hyperlinking proposal	Daniel Hardman
2 mins	Review of Decisions and Action Items	Chairs
1 min	Next meeting	Chairs

Notes

New members
1. Georgios Tsoukalas and Foteinos Mergoupis-Anagnou are from GRNET and have worked on the eSSIF-Labs terminology work
  1. They have joined to see if they can contribute to the joint work of the eSSIF-Labs terminology work and the CTWG
Using the Decentralized Governance white paper as a test of the hyperlinking pop-up proposal - Rieks Joosten
1. The idea is to make this white paper an example of how you can link to terminology in the CTWG corpus.
2. This particular white paper refers to terms defined in several different glossaries that have been ingested into the CTWG corpus.
3. So as a first step, the white paper needs to be converted into a Markdown file.
4. Then we need to figure out how the hyperlinked references and pop-up links will work.
5. We discussed the potential to ingest white papers that provide definitional input to the corpus.
6. Rieks shared two links to eSSIF-Lab terminology work that provides examples of how it works.
  1. https://gitlab.grnet.gr/essif-lab/framework/-/blob/master/docs/terms/agent.md is an example of an ingestible file that extends the Corpus.
  2. https://gitlab.grnet.gr/essif-lab/framework/-/blob/master/docs/functional-architecture.md is an example of an ingestible file for a whitepaper that uses/refers to terms
7. We looked at Wikipedia pages and how they do pop-ups and how the markup behind them worked.
  1. Dan Gisolfi found this information about how Wikipedia produces pop-up definitions in Wikipedia pages ("WikiLink Support requires Markdown Enhancement Plugins")
    1. https://github.com/yzhang-gh/vscode-markdown/issues/638
    2. So common rendering work has already been done for using Markdown for such popups.
8. So the problem breaks into two parts:
  1. How to add the necessary hyperlinks.
  2. How to render the pop-ups when viewing in a Web page format.
9. Daniel proposed that we accept this as a use case and example to implement the full process.
Discuss Terminology Engine v2 (TEv2) being developed at eSSIF-Lab by GRNET
Review of URL / hyperlinking proposal - Daniel Hardman
1. GitHub-style URLs to Markdown files render as HTML - example is Hyperledger Aries RFC documents
2. We should take advantage of several features GitHub already offers
3. Daniel Hardman recommends that we don't include mscope in the hyperlinks
4. Labels should be composed of both a human-friendly label and a number (the number identifying a different definition of the term)
5. For concepts, we might reverse it (number before name)
6. For versions, Daniel proposes that we use GitHub commit hashes
7. This gives up some human-friendliness but takes advantage of GitHub features
8. Dan Gisolfi asked a key question: is the primary output of our process a specific kind of an output?
  1. Pop-ups like Wikipedia are only possible with live web pages
  2. PDFs, for example, would not support pop-ups
9. Rieks pointed out that a PDF or a print version could include an Appendix to a document that provided an alphabetical glossary for the document
10. We had a long discussion about the separation of the curated artifacts and the rendered versions and what we need for authoring vs. what we need to be displayed. It focused on the Data Lifecycle slide below, and the question of which stage the hyperlink URLs should be produced: Curate, Produce, or Process.
  1. Daniel Hardman was okay with the idea of having a standard default GitHub Pages version of the curated content, but does not want to focus there; he would rather focus on the Process cycle.
  2. Dan Gisolfi wants to focus on a standard ToIP rendering of the glossary.
11. We ran 30 mins long in pursuing this discussion, which everyone agreed was excellent. In order to agree on next steps, we agreed to continue in Slack.
Review of Decisions and Action Items
Next meeting is in two weeks, Jan 18, at our regular timeslot (Mondays 10:00-11:00 PT / 18:00-19:00 UTC).