Last Thursday Rieks posted this Slack message. He agreed to make it the main topic for discussion on today's call:
@Drummond Reed @Daniel Hardman As I was looking into the user guide topic, I felt a bit confused, which I think originates from the level of (dis)organization of the 3 CTWG-related repos, their purposes (if specified), and their contents. I think we should discard what we no longer need. What I think we do need is the following:
- a template-repo that curators can instantiate and subsequently use to maintain the part of the Corpus that they curate. In my thinking, every Scope would be maintained in one repo (a Terms Repo), that is structured according to conventions that allow the stuff therein to be referenced and used across Term-Repo's = nicely 'decentralized'. Curators will use (predefined or self-defined) actions to construct their CI-pipeline for ingesting stuff; there SHOULD be a predefined action that can test the repo for structure etc. and that must succeed for a pull request to be merged.
- a template-repo, instances of which will be used by terms communities for creating ingestible stuff. The template with wiki-pages could serve this purpose. On the long run, we could have different "flavors"
- one repo in which CTWG maintains its documentation, which should include texts that document:
- what CTWG does, and what not
- the mental model(s) we use
- how people can contribute to the ingestion phase
- how curators can add ingestibles to the corpus
- what artifacts (e.g. glossaries, dictionaries, ...) can be generated, and what curators should do to configure the specific kind of artifact they want to end up with.
I would like to discuss this and establish consensus on the (more detailed) way forward, of which I hope the result will be that CTWG and eSSIF-Lab ways of working will grow towards one another, which makes life easier for me.
______________________________
- Rieks Joosten explained that our development of terms wikis addresses primarily the ingestion stage of terminology.
- But in going from a terms wiki to a glossary, we have challenges in terms of ongoing glossary management, stability of terms, references, etc.
- We don't have a corpus of terminology yet. So this is the proposed next step: to accept input from multiple sources, including terms wikis, into the corpus. Then the ToIP Term Tool can work with the corpus to produce the necessary artifacts such as glossaries, dictionaries, and document markup.
- Rieks suggests that we develop a standard repo setup (see screenshot #1 below) for a corpus that can produce pages in different outputs (see screenshot #2).
- Every participating terms community (ToIP WG, TF, etc.) would have its own repo — just as it does today with a terms wiki — only it would be more fully functioning.
- Rieks points out that any artifacts that the trust community produces that need to involve terminology can reference it from its glossary document.
- Judith Fleenor asked about the overall repo structuring proposal in contrast with other GitHub repo structuring proposals that ToIP is considering.
- Daniel Hardman said that he's not opposed to the idea of a richer type of terminology repo but wants to make sure that we are meeting the current needs of terms communities to use terms wikis and ToIP Term Tool V1 to meet their terminology needs.
- Rieks shared this link to an issue in the eSSIF-Lab repo that describes his vision and explores the architecture and technical tasks necessary to achieve it.
- Rieks does not expect that this is a "one and done" project, but a steady evolution of a project.
- ACTION: ALL INTERESTED CTWG MEMBERS to review this issue in the eSSIF-Lab repo to fully understand Rieks' proposal for terminology repos. Please post your feedback in the #concepts-terminology-wg Slack channel.