W3C

– DRAFT –
WoT Use Cases

05 March 2025

Attendees

Present
Ege_Korkan, Jan_Romann, Michael_McCool, Tomoaki_Mizushima
Regrets
-
Chair
McCool
Scribe
Ege_Korkan, EgeKorkan

Minutes

<McCool> mm: review minutes at https://www.w3.org/2025/02/26-wot-uc-minutes.html

McCool: any objections to minutes?
… hearing none
… minutes approved

Schedule

McCool: We have adjusted the schedule in PR 1225 of the wot repo
… any objections to merge?
… hearing none

<McCool> w3c/wot#1225

Conversion Script

McCool: can you show an example?

Mizushima: triple back quote in the template is new
… it is not necessary though
… I have added to the script a feature to remove that

McCool: ah ok this is doing a search and replace?

Mizushima: yes

McCool: will it give the same order though?
… I think it is close but we should be careful about changing the structure in the future

Mizushima: line 72 is new. That is what I meant

McCool: triple quotes are for examples of code
… we should change that to codeblock
… however in md, the beginning and end are the same. Not in html though

Jan: in the template, the quotes are for no reason indeed
… why not using something like pandoc btw?

McCool: not a fan of perl. Sadly not proficient with it anymore
… you are right probably
… fixing the template is better
… since we would fix the source

Ege: people can put their own example in triple quotes. like a td example
… we can ask them to put js or json

McCool: that will work
… we should test it though
… mizushima-san, can you put an output document for us to see

McCool: (makes a gh suggestion on the PR)

Ege: we should take js into account too

McCool: I will add that

McCool: (reviews the code)

McCool: does else work?

Mizushima: issue 324 is a user story
… that has the triple back quote

McCool: we should fix that US first

Mizushima: we can delete such lines by hand

McCool: yeah. just would be better to not

Jan: the PR 333 will fix that

McCool: yes. Let's fix that quickly though
… let's find one with code example

McCool: (edits Issue)

<McCool> mm: test case: w3c/wot-usecases#324

<McCool> w3c/wot-usecases#333

McCool: I will add instructions for using triple quotes with language
… how to escape though...

Jan: I was also confused with the usage of "US" for the label
… like the country code

McCool: yes true. let's fix it in another PR

McCool: ok when trying to make an issue, it does not show up
… ah it says too long line

McCool: (tries to fix it)
… ok let's search for that
… now it looks good with clear instructions that are correctly displayed

Jan: the field with motivation has confused me

McCool: yeah I know why. The template was removing the section titles
… an issue would be good

Mizushima: the title does not show up in the markdown
… it is only in the issue

McCool: ok that is another issue to be created

McCool: I want the id to be a concise
… using the title breaks that, it is too descriptive
… I will create a PR
… this change makes it possible to have a separate id field

McCool: however, we need to check if the id is unique

Ege: we can ask them to check the raw html

McCool: we can complain if there is a duplciate

McCool: they can also look in the url

McCool: but we are out of time now
… mizushima can you please add some test outputs
… and jan if you have a better idea for the script like using pandoc, go ahead :)

McCool: we can merge PR 335
… so to easily test it

Minutes manually created (not a transcript), formatted by scribe.perl version 244 (Thu Feb 27 01:23:09 2025 UTC).