Page Comparison

Meeting Date

• 04 Jan 2021 

Attendees

• David Luchuk

• Drummond Reed
• Rieks Joosten
• Daniel Hardman
• Dan Gisolfi
• Scott Perry
• Steven Milstein
• @Foteinos Mergoupis-Anagnou
• @Georgios Tsoukalas
• Scott Whitmire
• Paul Knowles
• RJ Reiser

...

Recording

• link to the file 

Presentation(s)

• link to the fileURL / hyperlinking proposal

Documents

• File 1 - link
• File 2 - link
  
• File 3 - link

• Decentralized Governance white paper

Notes

1. New members
   1. @Georgios Georgios Tsoukalas and Foteinos Mergoupis-Anagnou are from TNO 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
2. Using the Decentralized Governance white paper as  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 term 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 .
   7. Georgios Tsoukalas and Foteinos Mergoupis-Anagnou
   Discuss Terminology Engine V2 (TEV2
   1. 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 
   2. 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.
   3. 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.
   4. Daniel proposed that we accept this as a use case and example to implement the full process.
3. Discuss Terminology Engine v2 (TEv2) being developed at eSSIF-Lab by GRNET
4. Item 2
   
5. Item 3Review 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.
6. Review of Decisions and Action Items
7. Next meeting

Decisions

•  Sample Decision Item

Action Items

•  Sample Action Item

1. is in two weeks, Jan 18, at our regular timeslot (Mondays 10:00-11:00 PT / 18:00-19:00 UTC).

Slides

From URL / hyperlinking proposal (Daniel Hardman)

Image Added

Image Added

Image Added

Image Added

This last slide (above) is from the last meeting.

Decisions

•  We will use the Decentralized Governance white paper as a test case for both ingesting terms into and outputting hyperlinked content for the corpus.

Action Items

•  ALL: Continue discussion of next steps in the #concepts-terminology-wg channel in Slack.