Go To: Zoom meetings
Go To: Future-Topics
Go To: Guidelines
Go To: Meeting Reports
Host: Henk van Cann email / Co-Host: Kor Dwarshuis email
Meetings two times a week starting 2023-03-06:
Double check, times and dates may vary. We don't record so there are no recordings available.
Now and again we work a full week focussed. This is the issue/agenda of the next focus week where topics pile up:
https://github.com/WebOfTrust/WOT-terms/issues/130
Topics: git, github, github actions, NodeJS, NPM, JS, Docusaurus, React, Resources, Education-site, Spec-Up, readthedocs, Typesense
Join Zoom Meeting - Meeting ID: 685 970 2250 - Passcode: 1ekXu2
Once every 6 weeks we do a recap week of all quick 1-1-1-1-1 efforts. In agenda Henk: "Recap-week Kor": In 2024: week 12-18-24-30-36-42-48.
Added by Kor (2024-06-06): Fix Kerific Chrome extension. Does not meet Chrome web store requirements and could be removed in 30 days
2024-06-24 great work! -> 2 points left: 2 and 5
DECISION: installation spec-up-t described in README.md , configuration and use in Docusaurus site
DONE: Test user interface Github.com -> edit term file + commit, will Github actions be invoked? {Kor action} ==> Kor: Test result: yes, commit via webbased editing counts as a push and triggers the “gh-pages” Github Action
DONE: Diff: Kor solves the BUG (in issues). And we don’t keep track of commit hashes for ref, only xrefs; why not -> https://trustoverip.github.io/ctwg-terminology-governance-guide/#role-specification-terminology-author-covering-concepts
{user}.github.io/{reponame} What if user and/or repo will be changed in the future?? All xrefs would deliver a 404! ACTION Kor: test changing repo name.
DECISION: username has to be persistent.
DECISION: What if directory's name that contains terminology definitions is changed? No problem because the persistent link doesn't contian the directory name.
Agenda: TEv2 MVP next week
Action Kor: A. investigating the filtering of commit hashes based on date of a specification fix.
Action Kor: Issue155 Test the interference of spec-up versioning and git commit versioning per copied file
Action Kor: C. Add anchor links to the front-end (or do we have those already?)
Someone wants to fix a version of the entire specification at time T (snapshot) with the definitions and the external definitions that this specification refers to and at THAT MOMENT the latest represents and be able to show it in a kind of historical glossary in the future.
We can then, as Drummond first suggested, try to copy the Xrefs (references to external glossaries), but that seems "Hell" to me for various reasons.
My idea yesterday was to retrieve the correct version (commit hashes) of the internal and external referenced definitions based on moment T and make it available in the comparison tool. By comparison tool I mean this prototype idea, but for a single term file, e.g. "appraise.md". Described from here in Slack https://trustoverip.slack.com/archives/C01BBNGRPUH/p1714418484585169
and also discussed as Step 1 here: https://wiki.trustoverip.org/display/HOME/2024-05-06+CTWG+Meeting+Notes
Why should my approach be preferred?
Intended result: 1-1-1-1-1- try to show "what a date can do"
Structure Business Rules for Lead Terminology creators -> if not applied -> a Basic Active Linter-Corrector -> splitting possible.
Action: Kor pls Add https://hackmd.io/zku3Dn8qQeub_58Q1ivKLA in scraper.
DONE Action Kor: Tab in WOT terms sheet with overrides. Solution: just a link to the file from KERISSE How-we-did
DECISION: Try to automate documentation from the documentation in the source files. Doxygen for Bash and JSdoc for nodeJS.
Action Kor https://github.com/WebOfTrust/keripy/blob/development/docs/naming.md Python Style Guide for keripy
Overide: Python Naming, Python Style Guide
Action Henk: remove external links to other glossaries from text of the wiki definitions, because we have cross links (Dictionary)
Tue April 2: Done until 'E' - Wed April 3: Done until 'Q' - Thu April 4: Done till end
result here look for commits with text "xlink removed"
Action Kor: create OpenAI chatGPT channel https://chat.openai.com/g/g-mTlHjxQCp-keri-wizzard
DONE OpenAI chatGPT channel : how call the chatGPT from within Docusaurus with chat window.
Answer: not possible without external service
https://docs.github.com/en/actions/security-guides/automatic-token-authentication#modifying-the-permissions-for-the-github_token Kor looks into this related github API work.
Decided to show "1-1-1-1-1-1" examples more instead of deep diving into side-issues or completeness. More than one of those examples per week would be great (if doable), we strive for at least one.
Once every 6 weeks we do a recap week. In agenda Henk: "Recap-week Kor": In 2024: week 12 (last week :) ) -18-24-30-36-42-48.
Action Kor: scrape new glossary together by going through certain headings (Terminology) in these repo :
ONHOLD Kor and Henk plan to clone and study TEv2 beforehand in Feb-March, which already results in PRs (currently on modest scale):
STUDY Fri-Sat Introduction overview
DISCUSS Sunday Feb 25, Noon, 30 min
STUDY Mon-Wed Guides
DESIGN a test Thursday Feb 22, Noon, 30 min
IMPLEMENT a test / send PRs Thu - Sat
DISCUSS Sunday Feb 25, Noon, 30 min
Sunday March 3
Action Kor: Google Doc ToIP to Markdown in wiki-dir and 1 file, both represented in spec-up.
Action Henk: clean wiki WOT-terms of unwanted files: image.png and ls-result.txt
Discussed https://identity.foundation/spec-up/
Henk prepayment
Action Kor: Test pages KERISSE crash resolution (HvC: solution?), crash in Brave ==> subtitles clienModule disabled Testpage with subtitles working
Action Henk: How to use Consensus Feature of Kerific for various roles?
Discussed kerific consensus spec until anchor #what-advantagegoal-does-the-consensus-feature-have
Gov Doc Temp : search longest tail first + use column A,B,C to construct variable name.
Ad document Github Actions scripts: Documenting GitHub actions results in quite a bit more work, which is urgently necessary:
Regarding point 4: The scripts can be divided into:
Regarding point 6:
how-we-did directory revised by Henk, check @kordwarshuis TBW.
Kor: https://weboftrust.github.io/WOT-terms/docs/github-latest-activity not working
Action Kor: investigate? Typesense: sorting based on conditions -> could we do this for glossary hits?
'Click and add' in Kerific : subsets of glossaries possible for those who don't have one yet? Two tastes:
ownership (5 terms copied)| adoption (54 terms adopted)
Action: Henk - Technical design including Usecases
Action Kor: Add meaningful anchors to terms in Unified glossary that keeps the users inside KERISSE.
Action Henk: IP rights present -> how-we-did/ip-rights-scraping.md
Action Henk: define Kerific and Kerisse
==> https://github.com/WebOfTrust/WOT-terms/issues/134
Howto's of WebofTrust documentation effort in github project page: Howto
How can we use the hackmd Meeting agenda & action list better, less duplication of work and more results with fewer repetitions of moves and search work (less forced to cancel 6 months later)?
For example:
https://weboftrust.github.io/WOT-terms/docs/how-we-did/create-search-index?level=2
This link is self-explanatory, fine. It's the documentation link.
So not: https://hackmd.io/@hvancann/ry2EB_bq2?type=view#Typesense
But Typesense override method documented in June 2023 Archive WOT Education site Tech meetings
-
Any changes
Be notified of any changes
-
Mention me
Be notified of mention me
-
Unsubscribe
Subscribe