2021-06-21 CTWG Meeting Notes

Owned by Rieks Joosten
Last updated: Jul 01, 2021
3 min read

Meeting Date

  •  

Attendees

Main Goal of this Meeting:

Review the new glossary wikis and decide on next steps with them.

Agenda 

TimeItemLeadNotes
5 min
  • Start recording
  • Welcome
  • Antitrust Policy Notice: Attendees are reminded to adhere to the meeting agenda and not participate in activities prohibited under antitrust and competition laws. Only members of ToIP who have signed the necessary agreements are permitted to participate in this activity beyond an observer role.
  • Introduction of New Members
  • Agenda review
Chairs
5 min

Review of action items from the last meeting

  • Daniel Hardman Update the  spec for the ToIP Term Tool (GitHub-based Glossary Wiki support)
  • Daniel Hardman Review the draft bounty for any revisions needed for support of GitHub-based Glossary Wikis
  • Daniel Hardman Draft a new Confluence wiki page for a “Glossary Wiki User Manual”
  • Daniel Hardman Provide feedback on Drummond’s proposed draft “Glossary Wiki User Manual”
  • Rieks Joosten Try a dry run of the “Glossary Wiki User Manual” (assuming Drummond and Daniel get it done early enough)
  • Rieks Joosten Modify links to the terminology paper with one that isn't on Slack.
Chairs
20 mins

Daniel Hardman to explain setup of glossary wiki pages, and how the generation works. We will review the ToIP terms wiki as an example.

Daniel Hardman
15 mins

Discussion on how to proceed with provisioning more contents, and in particular how to ensure that it doesn't turn into a mess we cannot sort out any more, including:

  • Templates for new pages
  • Capitalization rules for terms
  • Linking within and across glossary wiki pages
All
10 mins

Decisions about next steps with the ToIP Term tool and bounty, including:

  • Updates to the spec
  • Placing the bounty
Chairs
5 mins

Review of decisions and action items and planning for next meeting

Chairs

Recording

Presentation(s)

Screenshot #1 from Daniel Hardman showing the different repos showing the glossary wikis that Daniel has set up.

Screenshot #2 showing an example glossary wiki page. All of these are children of the home page, which is the only page on the wiki that is not a term page.


Documents

  • File 1 - link

Notes

  1. New members
  2. Daniel Hardman explained the setup of glossary wiki pages and how the generation works, using the ToIP terms wiki as an example.
    1. Daniel showed how to create a new glossary wiki in GitHub based on the ToIP Term template repo. See screenshot #1 above.
    2. You can then start adding terms by following the Term Template. See screenshot #2 above.
    3. Daniel has begun two Markdown documents with instructions for using this:
      1. <placeholder link 1>
      2. <placeholder link 2>
    4. Daniel next showed the terms wiki at https://github.com/trustoverip/toip-terms/wiki as an example
    5. One area that Daniel suggests we discuss is the sections in the Term Template.
  3. Rieks Joosten shared the cautions that we are not yet ready to have folks "jump in" and start using it yet.
    1. First he suggests we put the wiki tools through their full pace, checking to be sure we have everything we need.
    2. We can then also adjust the specs for our ToIP Term tool.
    3. His suggestion is that we start experimenting with the existing wikis.
    4. He also suggests that we use GitHub Issues to start working issues with the ToIP Term wiki.
  4. Discussion of which repo to use for which
    1. Main repo for our WG - this is for our tooling and instructions for using the glossary wikis
    2. We should use https://github.com/trustoverip/toip-terms/wiki as an example
    3. We will need to document this clearly

  5. We need to discuss potential issues with how to proceed with provisioning more contents, including:

    • Templates for new pages
    • Capitalization rules for terms
    • Linking within and across glossary wiki pages
  6. We also need to discuss next steps with the ToIP Term tool and bounty, including:
    • Updates to the spec
    • Placing the bounty
  7. The agenda for the next meeting should include both #5 and #6 above.

Decisions

  • None

Action Items