We get requests from members who joined this CG in the initial incubation phase. However, they are not interested in WoT anymore and write the chairs for removing them from the list. However, the chairs cannot do it themselves and need to forward the requests to the system team.

A simple proposal would be to add information about this process in an email to help people unregister.

A bit of shooting itself in the foot but it would actually help identifying the people who are actually interested in the WoT activities

We have a variety of resources but we do not document how they should be named. I will list the types below with the convention next to them once they are decided.

• Meeting Minutes
• Presentations (pptx, pdf and sometimes others)
• Tutorials:
  • Slides
  • Videos
  • Subtitles
  • Folder of individual tutorials
• Simple markdown documents (mostly Readmes for now)

Currently, we have only 11 watchers of the repository, even though we get more participation in the calls and also some people who respond to the emails are not watching it. This means that once we send an announcement via the discussions tab, only 11 people will get an email but many more gets emails. We should discuss in an internal meeting how to get more people to watch and thus get the announcements.

Sometimes the text (along the audio) hides the slide/content.
e.g., Video 1 at 2:39, Video 3 at 2:58, Video 4 at 0:36 etc etc
I suggest to make sure that slides don't use the lower part of the content

Video 2 at 1:54
I would update the date... having the year 2016 seems somewhat old ;-)

Video 2 at 2:08
missing commas between CBOR, TExt, and Audio

Video 2 at 3:31
nesting of JSON snippet is a bit broken and some quotes are different/invalid (see base)

Video 4 at 0:58
JSON snippet not poperly formatted

Video 4 at 1:40
speaks about validation error.. but I think it is a syntax error instead

Video 9 at 3:38
Listing HTTP, WebSocket and CoAP should be limited with commas ","

While watching the videos before publication, some issues are noticed. I will extend this with anything we find:

• Video 2, Payloads and Headers, around 0:30: We say click on the cards but there is no card. We do not have the videos yet but we can at least point to the webpage and the webpage can have "Video will be available soon" placeholder.
• Video 2, Payloads and Headers, around 1:50: The date has 2016, which is too old. We can update to 2024.
• Video 2, Payloads and Headers, around 2:35: There is typo on "celcius" . It should be "celsius".
• Video 2, Payloads and Headers, around 2:51: We should say Thing Description at least. The "Also, many other API and configuration files use JSON." should become "Also, the core standard Thing Description, as well as many other API and configuration files use JSON."
• Video 2, Payloads and Headers, around 3:29: Indentation is broken
• Video 3, JSON, around 1:55: The audio says 5 primitive types but the video shows 4 and omits integer. To not mess up the timing too much, I think we can just add another box under number to show integer in the same slide but the audio should be definitely fixed.
• Video 3, JSON, around 2:30: The separation should have Object and Array with the current text in parentheses
• Video 4, JSON in Practice, around 3:20: The timing is off and the transition needs to be better. We should add a slide and say something like "Let's see JSON in programming environments" and then show the usage
• Video 8, JSON Schema in Practice - Validators, at the end the "you can click on the cards" comes too late, unnecessary pause.

We have to edit all the videos with the following:

• Change background music to one long music
• Change the ending visual to remove film reel and allow cards on YouTube
• Removing animated WoT logo since it overlaps with YouTube cards
• Change the ending voice to mention "You can proceed to the next tutorial by clicking on the card or the video description"
• Adding a placeholder for the subscribe card

Overall structure

General introduction followed by WoT specifics

Goals

MUST:

• Introduce essential Semantic Web technologies (RDF, Linked Data, JSON-LD, Knowledge Graphs, SPARQL)
• Introduce ontologies and maybe OWL (limit to useful profiles like RL or OWL LD) (SOSA/SSN, SAREF, iotschema.org, Brick, ...)
• Introduce how WoT uses the Semantic Web and semantic annotations (use cases: find/identify (groups of) Things, find/identify (groups of) interaction affordances, modeling the physical environment, modeling relations between Things)
  • Maybe limit to TD ontology without JSON Schema/Data Schema ontology

MAY:

• JSON Schema ontology
• Read-write Linked Data, 5 star LOD, LD principles, ...

(Likely) Non-goals:

• Description logics in detail
• Model theoretic semantics of RDF and OWL

Meta:

Maybe try to have consistent running example(s) throughout tutorials

Any feedback and comments appreciated!

Although mentioned in meetings, it is not documented how the workflow really is. It should be documented at https://github.com/w3c/wot-cg/tree/main/Tutorials/whatiswot

The video resolution is capped due to Murf.ai but technically we can export higher-resolution videos from powerpoint. We can discuss it in tomorrow's call if there is an easy way. The not easy way is to put audio and video into a video editor and quickly combine them.

Currently, when a review happens on a tutorial slideset, it is not possible to see what has changed (no git diff possible). Powerpoint does not have track changes feature like in Word so we need to see how we can improve this problem, maybe a plugin

Currently, we get the minutes after the meetings in links like https://www.w3.org/2022/09/26-wot-cg-minutes.html . This needs some post editing to make them look nice (remove draft, change names, etc.). We can write a github action that looks into our calendar for past events, deduce the link for the minutes and download the HTML file. Then, it can do some automatic fixes and submit a PR. The rest of the fixes can be done as edits on the PR.

After all, this needs to be sent to W3C.

We are heavily using the W3C calendar but it has some issues:

• People who join the CG do not get event invitations for previous events or previously started recurring events.

• It is not visible in the:
  • GitHub repo
  • Basic Homepage (https://www.w3.org/community/wot/)

• It is not possible to link to a series of events, e.g. we cannot say here is the link for the office hours, we can only link to a specific instance of it.

• There is no week view.

• See also w3c/calendar#91

After the charter feedback is complete, it would be nice to organize a joint session with the Webthing Protocol CG. TPAC might be a good time and aligning with the Japanese CG would be nice.

Take inspiration from https://github.com/json-schema-org/community/blob/main/CONTRIBUTING.md

As explained at https://docusaurus.io/docs/markdown-features/code-blocks#line-numbering, we can add line numbers to all code snippets. It makes it easier to screenshot and use in the videos like a small IDE.

Splitting JSON in two: JSON and JSON Schema
First page of both should be called "Introduction"

Coming from Office Hours:

If someone searches for "What is the difference between IoT and WoT?", there are a lot of results showing up. However, we do not have any documents explaining the difference that the people can refer to or so our explanation shows up in the search results. See below:

https://www.google.com/search?q=What+is+the+difference+between+IoT+and+WoT%3F&client=firefox-b-d&sxsrf=ALiCzsYcZ5WA8r-MYvW-JMWDDBH7uDXNMw:1668702503648&ei=J2F2Y6ePJ_v_7_UP_PGwyAc&start=10&sa=N&ved=2ahUKEwjnvtyf0bX7AhX7_7sIHfw4DHkQ8NMDegQIBRAW&biw=2133&bih=1085&dpr=1.2

This should be brought back to the WoT WG and IG since it seems that the internet is searching for it.

Edit: Added the mention that this was found based on the questions in an office hour session

In the office hours and internal meeting today, we agreed on providing a small hands-on tutorial for WoT using node-wot. The idea is to put everything at https://github.com/w3c/wot-cg/tree/main/Tutorials/quickstart with the following requirements:

• No need for local network
• Easy setup
• Get running code to get the feeling of WoT during TPAC and do something more later on

We think of offering the Eclipse Thingweb online Things so that people can write a Consumer script quickly.

We should add https://github.com/w3c/wot-cg/blob/main/Tutorials/whatiswot/Project_Details/video-information-template.md to all folders so that we can use that information when publishing to YouTube.

After the charter feedback is complete, it would be nice to organize a joint session with the WoT Japanese CG. TPAC might be a good time

We can use the announcements as an alternative to Twitter since we may have different people following

With the videos being online on YouTube publicly very soon, we should embed them into the website in the corresponding sections.