15:03:04 RRSAgent has joined #wot-td 15:03:04 logging to https://www.w3.org/2022/01/12-wot-td-irc 15:03:16 meeting: WoT-WG - TD-TF 15:03:37 cris has joined #wot-td 15:03:44 chair: Sebastian 15:04:21 present+ Kaz_Ashimura, Sebastian_Kaebisch, Cristiano_Aguzzi, Daniel_Peintner, Michael_Lagally, Michael_McCool 15:04:36 scribenick: kaz 15:05:26 present+ Tomoaki_Mizushima 15:05:47 agenda: https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf#Jan_12.2C_2022 15:06:43 q+ 15:07:07 topic: Discussion about new eventing approach (Michael Lagally) 15:07:45 mm: note we should be careful about what to do for this version 15:08:08 ml: (starting with Use Cases) 15:08:41 -> https://w3c.github.io/wot-usecases/ Use Cases doc 15:08:57 ml: many use cases there 15:09:46 -> https://github.com/w3c/wot-thing-description/issues/1323 wot-thing-description issue 1323 - Missing event/notification affordance or operation 15:10:41 q? 15:11:07 -> https://w3c.github.io/wot-architecture/#thing WoT Architecture - 8.1.1 Things and Consumers 15:11:11 q+ 15:11:24 ml: (describes the components, Things and Consumers) 15:11:32 q+ 15:11:40 dape has joined #wot-td 15:11:52 mm: Consumer is an entity consumes TD 15:12:12 ... but there is confusion about the roles 15:12:22 ... around clients 15:13:00 ... generally try to avoid client vs server 15:13:09 ack m 15:13:12 ack e 15:13:24 ek: don't think there is confusion 15:13:42 ... in MQTT, consumers are clients 15:14:12 ... in this abstract level described by Architecture, the model is covered by TD 15:14:37 ... also intermediary doesn't "consume" the TD 15:14:41 q? 15:15:10 ... one entity could handle both the roles, though 15:15:23 +1; this is my understanding too 15:15:46 q+ 15:16:46 mm: we still have issues pointed out by Lagally with HTTP, etc. 15:17:17 ml: both Thing and Consumer are Servients 15:17:28 q+ 15:18:16 q+ 15:20:23 ack s 15:20:31 mlagally_ has joined #wot-td 15:20:32 sk: misunderstanding here 15:20:39 q? 15:20:47 ... Consumer is an entity consuming the TD 15:21:19 ... Servient is defined as a software stack which can be used for both Consumer and Thing 15:22:22 kaz: agree with Sebastian 15:22:40 ... section "8.8 WoT System Components and their Interconnectivity" describes that 15:23:11 ... so probably that section should come earlier (than 8.1) 15:23:17 ml: right 15:23:19 ack k 15:24:06 ack mc 15:24:17 mc: let's think about webhook 15:24:34 ... web services expose webhooks 15:24:44 ... do we need to standardize the mechanism? 15:25:23 +1 to mmccool 15:25:29 ... the prescription should go to the Protocol Bindings and/or Profile 15:25:48 s/... the/mm: the/ 15:25:54 s/mc:/mm:/ 15:26:34 ml: what if there are 10 different mechanisms? 15:27:09 mm: we can put that into Profile 15:27:32 q? 15:28:18 q+ 15:28:55 ca: 2 points 15:29:09 ... connecting this to practical points 15:29:21 ... agree with McCool 15:29:33 ... describe protocols exposing the interaction 15:29:48 ... within the diagram in issue 1323 15:29:55 ... this is basically a subprotocol 15:30:21 ... if you're using a subprotocol for webhook 15:30:48 ... we can already describe that 15:31:07 (Lagally needs to leave) 15:31:16 sk: should continue the discussion next time 15:31:53 topic: Review PRs based on the feedbacks for the 2nd WD release 15:32:52 subtopic: editorial changes 15:33:03 -> https://github.com/w3c/wot-thing-description/pulls?q=is%3Apr+is%3Aopen+label%3AEditorial PRs with "Editorial" label 15:33:25 sk: would start with editorial ones 15:34:24 ... maybe some of the PRs may need further reviews 15:35:29 -> https://github.com/w3c/wot-thing-description/pull/1332 PR 1332 - fix: some HTML markup issues 15:35:34 sk: (goes through the diff) 15:35:44 mm: some typo there 15:35:51 sk: any other comments? 15:36:04 (none) 15:36:11 merged 15:36:48 -> https://github.com/w3c/wot-thing-description/pull/1333 PR 1333 - update abstract 15:37:07 sk: (goes through the diff) 15:37:27 mm: missing the subject of the sentence 15:38:17 sk: (goes through the remaining part) 15:38:44 mm: we should be careful 15:39:18 ... the original text might be better around "terms from the information model" 15:39:19 q? 15:39:23 ack cr 15:40:12 sk: (add edits) 15:41:39 q? 15:41:41 q+ 15:41:50 ack e 15:42:55 ack k 15:43:21 kaz: just to make sure, the PR adds changes for the namespace in section 5.3 as well. right? 15:43:39 sk: yes, strangely that has not been fixed yet 15:43:44 ... OK to merge this? 15:44:13 (no objections) 15:44:27 merged 15:47:43 -> https://github.com/w3c/wot-thing-description/pull/1334 PR 1334 - TD Info Model fixes 15:47:56 mm: maybe need to add another sentence 15:48:58 ... should remove the sentence now and create an issue for that 15:50:01 sk: (removes local/global) 15:50:27 s/global)/global before "schema")/ 15:51:57 ... (looks into the td-validatio.ttl too) 15:52:17 ... (confirms the namespace change for 1.1) 15:52:39 ... (then goes through the remaining changes) 15:52:46 ... would propose to merge this PR 15:53:03 mm: ok 15:53:32 ... let's create another issue as well 15:54:11 (McCool needs to leave) 15:55:16 merged 15:55:47 -> https://github.com/w3c/wot-thing-description/pull/1335 PR 1335 - fix: typos and grammatical errors 15:56:20 sk: (goes through the diff) 15:56:30 q? 15:56:48 dp: some conflicts there 15:57:52 sk: (looks into the conflicts) 15:58:02 ... (and adds edits) 15:58:14 ... (for index.html and index.templte.html 15:58:27 s/templte.html/template.html)/ 15:58:48 sk: any objections for merging this? 15:58:51 (none) 15:58:55 merged 16:00:01 -> https://github.com/w3c/wot-thing-description/pull/1336 PR 1336 - fix: some internal links 16:00:12 sk: (goes through the diff) 16:00:19 ... (then resolve the conflicts) 16:04:28 I'm unfortunately pulled into another meeting and cannot rejoin 16:07:05 sk: any objections? 16:07:07 (none) 16:07:09 merged 16:07:33 -> https://github.com/w3c/wot-thing-description/pull/1337 PR 1337 - fix: minor singular vs plural issue 16:07:45 sk: (looks into the conflicts) 16:09:17 merged 16:10:10 -> https://github.com/w3c/wot-thing-description/pull/1344 PR 1344 - fix: object definition ref in ObjectSchema 16:10:16 sk: (looks into the diff) 16:14:42 merged 16:14:50 rrsagent, draft minutes 16:14:50 I have made the request to generate https://www.w3.org/2022/01/12-wot-td-minutes.html kaz 16:15:28 topic: 3 PRs for 2nd WD 16:15:58 s/topic:/subtopic:/ 16:16:37 -> https://github.com/w3c/wot-thing-description/pull/1283 PR 1283 - update webhooks example #1283 16:16:44 s/ #1283// 16:16:52 sk: need Lagally's input 16:17:16 -> https://github.com/w3c/wot-thing-description/pull/1339 PR 1339 - update assertion td-context-ns-thing-mandatory 16:17:31 sk: (goes through the diff) 16:18:28 q+ 16:21:05 q+ 16:21:44 ka 16:21:48 s/ka// 16:22:41 kaz: wondering about the gray background under the table within section 5.3.1.1 16:22:45 sebastia_ has joined #wot-td 16:22:53 sk: caused by ReSpec maybe? 16:23:06 ... it describes assertions 16:23:08 kaz: ok 16:23:18 ... maybe caused by the assertion tool by McCool 16:23:50 ca: title to be extracted from the first object? 16:24:34 sk: would not see any problem about that 16:25:04 s/McCool/McCool then/ 16:25:24 ... can be merged then? 16:25:56 q+ 16:26:30 ack k 16:26:31 ack c 16:27:03 kaz: btw, from the readability viewpoint, it might be better to use bullet points to describe each definition 16:27:15 sk: right 16:27:33 ... would suggest we improve the style for the next publication 16:27:38 kaz: that's fine 16:27:41 q? 16:28:22 sk: (creates a new issue to improve the style) 16:30:25 -> https://github.com/w3c/wot-thing-description/issues/1353 Issue 1353 - structure assertations 16:30:55 -> https://github.com/w3c/wot-thing-description/pull/1339 PR 1339 - update assertion td-context-ns-thing-mandatory 16:31:39 sk: split an old bigger PR into small ones 16:31:48 ... some conflicts there 16:31:56 ... (look into the conflicts) 16:34:18 ... any objections to merge it? 16:34:21 (none) 16:34:22 merged 16:34:53 -> https://github.com/w3c/wot-thing-description/pull/1340 PR 1340 - Manifest 16:35:10 sk: (looks into the diff) 16:37:24 ca: looks reasonable 16:38:10 dp: my concern is (like Ben) introducing changes not directly related to manifest 16:38:46 sk: right 16:38:55 ... (adds comments on that issue) 16:39:17 ... new PR will be provided with the changes on manifest 16:39:28 ... so won't merge this PR itself 16:40:14 -> https://github.com/w3c/wot-thing-description/pull/1341 PR 1341 - schema term in expected response 16:40:30 sk: (looks into the diff) 16:40:57 -> https://pr-preview.s3.amazonaws.com/w3c/wot-thing-description/1341/21ce84a...00eef3d.html#expectedresponse 5.3.4.3 ExpectedResponse 16:43:01 q+ 16:43:34 ack e 16:43:45 q+ 16:44:34 ek: agree with use cases but making this would make TD complicated 16:44:50 ca: complicated to understand what would be output 16:44:52 q? 16:44:55 ack c 16:45:02 ... also difficult to validate the data 16:45:49 ... so tend to agree with Ege 16:47:07 mjk: more work needed, but seems this is what we want 16:48:16 sk: would be OK not to merge this for now? 16:48:35 ... need more background before merging this 16:48:40 q? 16:48:43 +1 16:48:44 kaz: yes 16:48:58 s/yes/yes, we can wait/ 16:50:11 s/kaz: yes, we can wait// 16:50:20 i/+1/kaz: yes, we can wait/ 16:50:30 rrsagent, draft minutes 16:50:30 I have made the request to generate https://www.w3.org/2022/01/12-wot-td-minutes.html kaz 16:51:14 rrsagent, make log public 16:51:15 rrsagent, draft minutes 16:51:15 I have made the request to generate https://www.w3.org/2022/01/12-wot-td-minutes.html kaz 16:52:57 -> https://github.com/w3c/wot-thing-description/pull/1283 PR 1283 (revisited) - update webhooks example 16:53:19 sk: Lagally is not here but skim the changes 16:53:25 s/skim/would skim/ 16:53:33 ... (go through the diff) 16:54:51 ... Editor's Note is also added 16:55:14 ... would be happier to have Lagally here 16:55:57 ... but what do you think about this PR? 16:56:06 q? 16:56:19 ca: your changes are for examples 16:56:23 sk: yes 16:56:33 ... to make it clear 16:56:51 ca: improving the examples is OK 16:57:09 ... but we can split the example part and the other part 16:57:23 s/for/mainly for/ 16:57:34 ... anyway, having Lagally would be better 16:58:37 sk: this PR is about the examples within the Appendix 16:59:41 ... (adds comments) 16:59:46 ... OK with merging 17:00:33 ... but should improved the example or add another example to show another option about webhook-bsed approach 17:01:27 ... see also issue 1323 17:01:47 -> https://github.com/w3c/wot-thing-description/pull/1283#issuecomment-1011259925 Sebastian's comments 17:02:24 sk: (resolve conflicts) 17:03:17 merged 17:03:35 sk: then let's continue the discussion on webhooks 17:03:56 ... would like to get resolution next Wednesday 17:04:35 ... will continue the discussion on new event proposal from Lagally too 17:04:37 [adjourned] 17:04:42 rrsagent, draft minutes 17:04:42 I have made the request to generate https://www.w3.org/2022/01/12-wot-td-minutes.html kaz 17:18:58 sebastian has joined #wot-td