---
tags: KERI, CESR, OOBI, ACDC, Docusaurus, REACT, Javascript, JS, JSX, MDX, Education, Github, Git, Actions
---
Current WOT KERISSE Tech Meetings [Education site Tech meetings](https://hackmd.io/2C8ch1meS6ad3F3g2aEewg)

### 2023-05-20 Workshop Sellingen day 3
Henk van Cann
Kor Dwarshuis

- [X] Kor: level 2 gone
- [x] Kor: G=General S=SSI context K=KERI/ACDC specific
- [X] Henk: answer Rieks' basic questions, see below.
- [x] Henk: Rieks urge to formulate objectives clearer and simple: just one target group one goal to start with. Make a frontpage text.
- [x] Kor puts text in Docusaurus front page.

### Don't make me think
*title of Steve Krug's book; below 'He' for the sake of brevity, also read her, it, shim, etc, whatever you like*

According to the terminology pro Rieks Joosten I’ve been too “active” creating the glossary. His advice:

As soon as you want to develop an activity -> stop!, First ask yourself and others: [what is the result of this](#What-is-the-result-of-this), who is going to use this and what should they be able to do with it?
Ask people that come up to the team to know more about the KERI suite:
What is this? Who is going to use this? and what can he do with it, that he can’t do with anything else.
I’m convinced Rieks is right because we come to a grinding halt trying to use the glossary in the Education site. Too many angles combined in the acdc wiki texts… We’ve to discuss this with the team. And then reorganise the glossary according to the answers on Rieks’ questions.

#### What is the result of this, who is going to use this and what should they be able to do with it?

##### What is the result of this?
A site as a collection of relevant resources where consensus is achieved about what the meaning of certain terms are, but only in the context of the full KERI suite*
The output level of understanding of our target group is at least 3. [Levels explained](https://github.com/WebOfTrust/WOT-terms#levels-of-understanding).

##### Who is going to use this?
Technical Self-Sovereign Identity experts who are developers too. So both developer skill as well as having fundamental knowledge in the topics: cryptography, SSI and governance. The input level of understanding of our target group is at least 2.

##### What should they be able to do with it?
1. Trust the completeness and actuality of the resource-scraping behind it.
2. Glossary service at various levels of understanding, to achieve consensus plus share their (search) results with others for communication purposes.
3. Learn about the historical concepts and choices behind all KERI parts to better understand the Why's of it all (and not only the What and How)
4. "See" the structure of the code in various programming languages much clearer, the ability to question the structure more dynamically and more visual (like Rust has build in).

'* KERI, ACDC, CESR, OOBI, etc

### What is this?

**KERI suite search engine (KERISSE)**
*Personal learning environment and consensus building with others*

### Who is going to use this?
See above and any guest user starting at level 1 ((say starting from "E-Identity expert") is welcome too. Laymen might get lost, we'll accept this**, the site is targetted at experts.

'** Trying to educate laymen on SSI and KERI suite terminology introduces a whole next level of complexity (hard-felt experience :) )

### What can he do with it, that he can’t do with anything else?

Anything else does not have the intelligence built-in that combines proper selection and labelling of resources, categorizations and ranking of resources on one hand and scraping and indexing with a fit-for-purpose customized search engine on the other hand that results in manageabe and properly ranked search results. The results are accessible through tailor-made filters in the left menu of KERISSE.
Currently Github nor Google and even AI can't deliver this content.

### 2023-05-19 Workshop Sellingen day 2
Henk van Cann
Kor Dwarshuis

- [X] Henk creates 7 groups out the 70 repos of Weboftrust - the link to the repos is enough. The simplest solution: use the Language-filter of the Weboftrust account [here](https://github.com/orgs/WebOfTrust/repositories) to group the repo in the left menu of the WOT-terms site
- [ ] ONHOLD Kor Impose _graph tool_ on m words times n repos in combination with the words 'use {rust module m}' - 'import {python module m}'; repos including type 'forks', excluding 'archived'
- [ ] ONHOLD Kor Indexes on m words times n repos. Priority for the words m combination with hits in the n repos 'use {rust module m}' - 'import {python module m}'; repos including type 'forks', excluding 'archived'
- [X] Henk: Get a paid Typesense account, able to share with colleagues (like Kor)

### 2023-05-18 Workshop Sellingen day 1
Henk van Cann
Kor Dwarshuis

## Typesense
Do you have any specific questions you'd specifically like us to cover during the call?:
1. Github actions automation of:
- Crawling (Puppeteer)
- Importing
2. What would cause Typesense cost excess, in order to avoid these things from happening.
3. How do we tap into the Typesense community?
4. What are the settings in the pricing for us, as an open-source non-for-profit project?
5. How do we set up the staging environment

Answers Jason:
1. https://github.com/marketplace/actions/run-typesense-docsearch-scraper
2. Set up something like Cloudflare DNS (to avoid DDOS consequences)
3. [Join Slack](https://join.slack.com/t/typesense-community/shared_invite/zt-mx4nbsbn-AuOL89O7iBtvkz136egSJg) - public via Google - Jason: The platform I was telling you about is called https://struct.ai/. It essentially builds a public knowledge base like this based on conversations in your public Slack channels: https://threads.typesense.org/kb
4. No, take the cheapest tier, it's great value for money
5. Two collections within the same cluster

- [X] Future topic CR problem in .md
- [x] Set Type field WOT-terms SHEET - Henk
- [X] Write in GoogleSheet - Kor - result in chatGPT Kor. Decision: too much work.
- [X] Future topic 8 june 23: level if Puppeteer matches something

### 2023-04-20
skipped

### 2023-04-20
Henk van Cann (host)
Kor Dwarshuis (co-host)

Recording: no

- [X] Action Henk: choice of commercial version of Algolia: "Grow" and we have asked a price quote for the crawler.
- [x] Action Kor: install Google Search or the other one: Typesense
- [x] Action Kor: ask support for URLs in search results HOW.

### 2023-04-17
Henk van Cann (host)
Kor Dwarshuis (co-host)

Recording: no
- Decision: choice for commercial version of Algolia
- [x] DEPRECIATED Action Kor: Next focus on Algolia API how to put the results into DS.
- [x] Action Henk: reduced branches
- [x] Action Kor: Study in depth [How Algolia counts (and invoices!)](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-); follow all links

### 2023-04-13
Henk van Cann (host)
Kor Dwarshuis (co-host)

Recording: no
Actions
- [X] Future topic Kor: Store Google API key in Github secret?
- [x] Kor: subscribes to https://discourse.algolia.com/ to post problems
- [x] Henk: what is the pay-per-? (measurement?) in the commercial suit: 1. search requests (operations) e.g. minimum amount of characters typed in search box before search start / multiple queries, 2. records - pre payment for extra records (including) / mind virtual and standard replicas.
[source](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-)

- [x] Henk: other non-algolia controlled fora? Docsearch experience.
- https://trends.builtwith.com/websitelist/Algolia we could ask around here.
- [x] Kor: ask question in Docusaurus discord about reach of free version Algolia - what can do with it and is it enough. Kor asked ChatGPT.
- [x] Kor legt antwoord ChatGPT voor aan support desk

### 2023-04-03
Henk van Cann (host)
Kor Dwarshuis (co-host)

Recording: no

### shell scripts
We might need a basic shell script to wrap a \<div> around .md and implant frontmatter too. The source directory will be a subdir, destination one higher up the tree.
Action:
- [x] DEPRECIATED Henk makes a script
- [x] DEPRECIATED Kor tries to put it in GIthub action afterwards.

### JSON steering of Algolia backup
- Agreed on the fact that we choose the most customizable filtering option in Algolia
- Agreed that we follow the Algolia conventions for designated classes on important filter like levels.

Action:
- [x] Henk amends https://hackmd.io/rWVdv0-xR_S-ASkkVUG2zg and
- [x] Kor implements those amendments

### Mental models
How to combine [WOT terms database](https://docs.google.com/spreadsheets/d/18IUa-1NSJ_8Tz_2D-VSuSQa_yf3ES1s_hovitm3Clvc/edit#gid=209150977) **Type** field with the reality of distinctive mental models and scopes, while editing the [glossary at ToIP](https://github.com/trustoverip/acdc/wiki).

Circles are a visual representation of the three mental models we consider and how they could overlap (in their criteria for border-case situations in which something applies to - or doesn't apply to a certain term):
G : General computer and digital information sience
S : Self-Sovereign Identity world
K : the full KERI suite: KERI, OOBI, CESR, ACDC, IPEX, etc
> An assumption is that the KERI scope is considered part of Self Sovereign Identifier scope and this scope is considered part of the General computer language scope.
>

- Typical examples that we would like to typeset beforehand (to capture expert knowledge that explains different views visually)
- https://github.com/trustoverip/acdc/wiki/payload -> G and K diverge!
- https://github.com/trustoverip/acdc/wiki/first-seen -> K defined this term anew, so it's also applicable to S and G, as long as noone in the broader field starts using it for something else.

https://en.wikipedia.org/wiki/Venn_diagram theory, maybe there is solution to action:
- [x] Henk finds a way to express in code all possible situations Venn overlap / non-overlap / fully contained in, etc.
- Discussion with Riek: hold your horses, first a few questions to be answered
- [x] Kor: https://codepen.io/shacheeswadia/pen/XWKZPxy

### 2023-03-13 - 2023-03-30
Henk van Cann (host)
Kor Dwarshuis (co-host)

Recording: no

No meetings because Henk recovering from flu.

### 2023-03-13
Henk van Cann (host)
Kor Dwarshuis (co-host)

Recording: none

### Announcements
Sustainable Github Support Team at ToIP will be set up, but with volunteers, organise your own budget?

### Topics
- Pulling in values for variables: JSON structure loaded succesfully from Google Sheet

Done; see https://dwarshuis.com/test/wot-terms/3/docs/overview/?level=3 (hopefully it'll still work, it's a test server)

Next step: how to edit and sign off the edits, a string of signed edits should become available (the blame of Github).
investigate the possibility of a seperate repo solely for this.

### 2023-03-09
Henk van Cann (host)
Kor Dwarshuis (co-host)

Recording: none

### Topic
- In the current Wot terms site, I see texts in the MD files that are not reflected in your shared google sheet. But the Excel sheet you used as a source for MD files is now the google sheet, but then where has that content gone in the google sheet?

### Actions, findings and decisions
Decision: Kor and Henk went through the [broader perspective](https://hackmd.io/pRuinoVJSZGT1xQT5ywIYA#The-broader-perspective) to transfer the knowledge of how we did update content in the Edu site. There is also howtos [here](https://weboftrust.github.io/WOT-terms/docs/howto/intro?level=1), that may vary in correctness regarding the Docusaurus site (because we switched from Jekyll). The decision we made is that pulling in - and controlling every single field of the Google sheet WOT-terms by Kor within DS is a good start to be able filter, sort, select on the content.
- [x] Action: Kor pulls in - and controlling every single field of the Google sheet WOT-terms
- [x] Action: Kor got it going in draft, March 13
- [X] Future topic: Henk updates all howtos

### Actions, findings and decisions

### 2023-03-06
Henk van Cann (host)\
Kor Dwarshuis (co-host)

Recording: none

### Topic
1. GitPro Book chapter GitHub
2. Moodle and questions Martijn vs. use ChatGPT to generate questions
3. Algolia
4. Docusaurus
5. ChatGPT
6. Henk's level regarding frontend and learning points

### Actions, findings and decisions
- [X] Henk creates this charter en reports the first meeting
- [X] Ad 1. read from `Pull Request Refs` - gitpro book, Henk
- [x] Ad 1. read from `Pull Request Refs` - gitpro book, Kor
- [x] Ad 2. Moodle and Martijn's questions -> Kor offers to review them. Do 10 or 20 and come up with comments that he could also apply to the remaining 80 himself.
- 3. Decision: the search of DS : even if we can control it (level, context-role), we are not going to use it because the investment in Algolia is worth it.
- [x] 3. Action Algolia: 1. repeat course in max 2.5h
- [x] 3. Next focus on Algolia API how can we control from DS the search movements (level, context-role, etc) with JS.
- [x] 3. Planned Algolia on Thu March 30 at 12AM UTC, 13PM AMS time.
- [x] [Data Pipeline and Indexing](https://academy.algolia.com/collections/ed96a4d0-7480-11ec-a4d9-06c0361096e5)
- [x] [Send Data to Algolia with the Dashboard](https://academy.algolia.com/training/a3f77490-7781-11ec-91df-02aea812ea2d/overview)
- [x] [API](https://academy.algolia.com/training/f6de1d9e-7781-11ec-8ef9-06cf503dca07/overview)
- [x] [Crawler](https://academy.algolia.com/training/ded6294e-7781-11ec-990d-02aea812ea2d/overview)
- 4. Docusaurus:
- [x] Many links causing pages to crash -> remove ( ), Henk creates a tab in WOT-terms with filename - desired filename for DS
- [x] slug: | something | should be added -> Kor loads right names from WOT-terms tab created by Henk; see above
- Finding: Kor currently does nothing with React in DS, writes plugins by himself
- 5. Finding: ChatGPT is the way to go.
- 5. Decision: Kor can use chatGPT even when we need to pay (Henk pays)
- 6. Finding: Kor's advice: work a lot with the Inspector in Brave: Elements, COnsole

Kor git question: push to a branch not being main produces a trigger for GH actions and it fails, of that Kor gets an email. Why?
- [x] No clue yet, Action: try to find out as we go with the Actions Deep Dive