13:52:55 RRSAgent has joined #wot-td 13:52:55 logging to https://www.w3.org/2021/09/15-wot-td-irc 14:02:38 citrullin has joined #wot-td 14:02:54 cris has joined #wot-td 14:03:49 sebastian has joined #wot-td 14:04:30 dape has joined #wot-td 14:06:04 Mizushima has joined #wot-td 14:06:40 present+ Kaz_Ashimura, Sebastian_Kaebisch, Ben_Francis, Cristiano_Aguzzi, Daniel_Peintner, Jan_Romann, Michael_McCool, Philipp_Blum 14:07:28 meeting: WoT-WG - TD-TF 14:07:32 chair: Sebastian 14:07:33 jkrhb_ has joined #wot-td 14:07:38 scribenick: cris 14:07:52 topic: Previous minutes 14:07:55 present+ Jan_Romann 14:08:07 mjk_ has joined #wot-td 14:08:36 seb: we review some PRs 14:08:49 rrsagent, make log public 14:08:57 ... notice that today we'll review signatures 14:08:59 present+ Michael_Koster, Tomoaki_Mizushima 14:09:12 ... we discussed also about action operations 14:10:01 i|we review some|-> https://www.w3.org/2021/09/08-wot-td-minutes.html Sep-8| 14:10:06 ... then we had a presentation about a new Action model from Cristiano. it is available on github 14:10:28 agenda: https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf#Sept_15.2C_2021 14:10:33 ... we should evaluate it in a plug fest. Together with the current proposal 14:10:58 ... then we discussed about initial connection in forms 14:11:11 ... some doubts about the operation type. 14:11:20 ... minutes look okay? 14:11:28 ... ok then they are approved 14:11:33 topic: TD signatures 14:11:43 mccool takes the stage 14:12:35 mc: I set a new w3c repo called wot-ejs. Ejs stays for Enveloped JSON Signature 14:12:52 ... the document skeleton is already in place 14:13:18 ... some steps are really related to TD, I need to remove this dependency 14:13:27 i|takes the|-> https://w3c.github.io/wot-ejs/ Enveloped JSON Signature draft| 14:13:35 rrsagent, make log public 14:13:40 rrsagent, draft minutes 14:13:40 I have made the request to generate https://www.w3.org/2021/09/15-wot-td-minutes.html kaz 14:14:12 ... when computing the signature is safer to inline a referenced object 14:14:43 ... I'm looking for solutions 14:16:04 q+ plular for securityDefinitions and schemaDefinitions? 14:16:16 q+ 14:17:04 dape: we used to have securityDefinition object called securityDefinitions 14:17:11 ... is it the same? or a new one 14:17:15 ack p 14:17:15 plular, you wanted to discuss securityDefinitions and schemaDefinitions? 14:17:26 mc: it should be schemas probably 14:17:29 s/plular/dape/ 14:17:46 ... and securityDefinitionS 14:18:54 ben: inline objects are interesting, +1 about doing this in 1.1 14:18:58 ack benfrancis 14:19:08 q+ 14:19:39 https://github.com/w3c/wot-thing-description/issues/300 14:20:04 McCool has joined #wot-td 14:20:45 mc: we labeled the issue as deferred 14:20:54 ... cause it breaks reto-compatibility 14:21:02 ... we have breaking changes 14:21:20 ... we probably can go with it but we need to least breaking changes 14:21:24 ... and warn people 14:21:38 ... this would help canonicalization 14:21:57 ... a canolical TD will always be 1.1 14:22:04 s/reto/retro/ 14:22:11 ... it improves verbosity 14:23:34 cris: do we need to stick with 1.1 label? can we go directly to 2.0? 14:23:42 mc: makes sense 14:23:48 ... is another approach 14:24:12 seb: we also did some breaking changes with forms 14:24:59 ... however we can mitigate it with text about how to be really backward compatibile 14:25:24 ... we don't have strong constraints 14:25:35 ... about backward compatibility 14:26:07 ... 2.0 is next charter 14:27:01 ... but maybe we can skip directly 1.1 14:27:11 cris: yeah that was my point 14:27:17 q? 14:27:25 ack c 14:27:30 mc: beside this, should I go on with a PR for 300? 14:27:34 q+ 14:27:46 seb: we can decide this in Tpac 14:27:56 s/Tpac/TPAC/ 14:28:01 ... and yes please go ahead with the PR 14:28:30 kaz: I want to stress the importance of backward compatibility 14:28:46 ... we have to think about it in every version (even 2.0) 14:28:57 ack k 14:29:03 ... we need to be consistent 14:29:25 mc: another option is to write down just the breaking changes as 2.0 spec 14:29:50 ... and then publish a full spec 2.1 14:31:34 ... I'll go ahead with a PR 14:31:51 seb: ok, it is an important topic to be discussed during PR 14:32:02 https://github.com/w3c/wot-thing-description/issues?q=is%3Aissue+is%3Aopen+label%3A%22Defer+to+TD+2.0%22 14:32:15 mk: do we have list of priorities for breaking changes? 14:32:32 seb: we was very careful about not-breaking backward compatibility 14:32:49 ... i don't know about other breaking changes 14:33:47 ... it is not easy to define backward compatibility with TD 14:33:52 q+ 14:34:22 ... for example if it checks the context link it would already fail cause it is different from 1.0 14:34:40 ack j 14:35:01 jan: is the context enough to differentiate between two different versions of TD? 14:35:21 seb: yeah it should 14:35:44 q? 14:35:51 jan: then yes the consumer should be able to handle multiple TD versions 14:36:06 seb: I'd like to postpone this discussion to TPac 14:36:46 topic: PRs 14:36:57 seb: I'm still working on 1207 14:37:53 ... is 1208 ready? 14:38:15 ... there is also an additional PR 1226 14:38:32 ben: the twos PR are identical except for the operation names 14:39:42 ... pr is tackling representing action queues 14:40:09 q? 14:40:23 -> https://github.com/w3c/wot-thing-description/issues/302 related Issue 302 - How do you cancel or query the state of an action request? 14:40:34 ... I tried to use the changes to create a new TD but it creates a big TD 14:41:30 ... futher more it is not clear how consumer would use variables to interrogate an action instance 14:42:02 ... simple use case becomes more complex 14:42:40 q? 14:42:49 ... my final idea would be to use Profile mechanism to describe this use case 14:43:02 ... separate the problem in twos 14:43:07 ... query/cancel action 14:43:14 ... and how to deal with queues 14:43:51 seb: I agree, the TD is super complex 14:44:06 ... my feeling is that the community will not use it 14:44:53 ... what about subprotocol? 14:45:14 ... like a deafult 14:45:32 ... maybe it could clearify how to link variables 14:45:45 ... and remove a couple of forms 14:45:55 ben: I kind of agree 14:46:17 ... but it works only for green field devices, which is what core profile is there for 14:46:55 ... you need out of band information 14:47:05 mk: collection supports would be nice 14:47:21 i|I'm still|-> https://github.com/w3c/wot-thing-description/pull/1207 PR 1207 - WIP: Updates for TM Chapter| 14:47:39 ... would solve also this problem, is it? 14:47:43 i|I'm still|-> https://github.com/w3c/wot-thing-description/pull/1208 PR 1208 - Add queryaction and cancelaction operations - closes #302| 14:48:07 ben: there is a gap 14:48:20 ... we encountered the same problem in discovery 14:48:30 ... different proposal but none of them quite work 14:48:41 i|I'm still|-> https://github.com/w3c/wot-thing-description/pull/1226 PR 1226 - Add queryactioninstance and cancelactioninstance operations - closes #302| 14:48:41 ... we can continue down the road 14:48:50 rrsagent, draft minutes 14:48:50 I have made the request to generate https://www.w3.org/2021/09/15-wot-td-minutes.html kaz 14:48:50 ... how open api solve this 14:48:55 q? 14:49:24 seb: how this will look like in the core profile? 14:50:06 ben: very simple TD with a simple url enpoint for an action 14:50:13 ... and apply all the defaults 14:52:52 cris: we may find a way in the end 14:53:17 ben: I also found out that the core profile there are missing piecies 14:53:50 ... plus I agree go down with core profile 14:54:05 ... and keep working on hypermedia approach 14:54:23 q? 14:54:23 mk: collections might be really the key 14:54:26 q? 14:54:49 seb: I still don't understand how a TD will look like with the core profile 14:57:17 ... thinking also about plugfest in two weeks 14:57:36 ... I would try to implement both 14:57:55 ... understanding benefits of both 14:58:06 ben: +1 14:58:23 ... I have two PRs open which one should be choose? 14:58:49 ... I'd go with 1208 14:59:00 ... for simple use cases this is all you need 14:59:14 ... then we need more implementation expirience 15:00:24 ... if we'll try to describe this we need a simple mechanism that can be easily implemented by consumers 15:00:33 q? 15:00:46 seb: fine for margining 15:00:56 cris: +1 for merge! 15:01:21 -> https://github.com/w3c/wot-thing-description/pull/1208 PR 1208 - Add queryaction and cancelaction operations - closes #302 15:01:57 mc: is webthings doing something like this? 15:02:03 seb: I'm working on it 15:02:11 s/seb/ben/ 15:02:22 ... but first only invokeaction 15:02:34 mc: node wot will do it? 15:02:36 dape: yes 15:04:15 seb: we are getting closer 15:05:11 subtopic: PR 1227 15:05:29 jan: small clean up of merge commit fragments 15:05:34 ... content is preserved 15:06:49 seb: good 15:06:55 mc: approved 15:07:31 seb: merged 15:07:44 topic: Issues 15:08:12 subtopic: Issue 1217 15:09:01 seb: how to describe SenMl? it has its own payload pattern 15:09:17 ... it is annoying to describe it in every interaction affordance 15:10:35 q? 15:10:37 q+ 15:10:37 ... we don't have a way to describe payload patterns 15:10:44 ... should we add it? 15:10:58 ... is it a protocol binding topic? 15:12:10 ... ege proposed why don't use schemaDefinitions? 15:12:43 ... it would be cool to have external schema definitions 15:13:08 q? 15:13:08 q+ 15:15:02 mk: I already have some TD conformant to SenML, I don't know what we are trying to accomplish here 15:15:12 ... what about using content format? 15:16:46 ... we can re-use patterns that are already there (using senml+cbor) 15:17:30 philipp: base name is just the Id in the TD, unit are repeated 15:17:45 ... I would like to use every opportunity where I can skip data 15:17:48 ... not repeting 15:17:50 q+ 15:18:32 mk: ok got it if something don't change that can be in the schema 15:18:41 q+ 15:19:08 phillip: senMl can be skipped 15:19:09 ack mjk 15:19:13 ack cris 15:19:26 sorry kaz but I am in the queue 15:19:27 :) 15:19:37 I still have to speak :D 15:19:40 q- 15:19:41 q? 15:19:48 q++ cris 15:19:55 q? 15:19:59 q- + 15:20:05 q- 15:20:06 q+ 15:20:08 qq+ cris 15:20:14 mk: I don't favore subprotocol 15:20:20 q- cris 15:20:53 ack _m 15:21:03 rrsagent, draft minutes 15:21:03 I have made the request to generate https://www.w3.org/2021/09/15-wot-td-minutes.html kaz 15:24:23 (sorry, have to drop) 15:24:30 i|how to describe Sen|-> https://github.com/w3c/wot-thing-description/issues/1217 Issue 1217 - Payload pattern binding| 15:24:57 s/(sorry, have to drop)/(McCool leaves)/ 15:25:02 q? 15:28:26 q- 15:30:54 q+ what about json schema "default" term 15:31:13 q+ to what about json schema "default" term 15:31:52 q+ 15:35:20 q- 15:37:09 ack c 15:37:11 ack d 15:37:11 dape, you wanted to what about json schema "default" term 15:38:23 ack dape 15:41:11 (some more discussion) 15:44:11 q+ 15:46:15 discussion about how to describe SenML in the TD 15:46:22 q? 15:46:25 Sebastian picks up 15:46:42 seb: maybe it is a common pattern also in philipp HUE 15:47:07 kaz: we should think about concrete use cases, ideally during TPAC 15:48:01 ... during PF call we was wondering why we were just a small group 15:48:11 ... I would suggest to bring this problem there 15:48:51 cris: +1 for having this in a plug fest 15:49:03 +1 from me as well 15:49:26 fair enough, good point :) 15:50:12 seb: can I ask to mjk to paste TDs in the issue body? 15:52:04 q? 15:52:12 ack k 15:52:24 subtopic: Issue 878 15:52:36 seb: forms should be optional? 15:52:57 ... ben is not ok with open operation name 15:53:58 ... the motivation was to differentiate to other forms entries 15:54:13 ben: for web socket does not really needed 15:54:58 ... plus the operation name applied to a device is weird 15:56:02 seb: yeah I this should work without operation type 15:56:49 ben: I would start to putting some text saying that forms are optional 15:57:48 i|forms should be|-> https://github.com/w3c/wot-thing-description/issues/878 Issue 878 - Describing initial connection| 15:57:52 cris: I would mention validation problems 15:57:55 s/philipp HUE/philips Hue/ 15:58:05 ... i.e. a TD may have no forms at all 15:58:20 seb: PR in flight for next week 15:58:52 ... closing the meeting, we are moving forward 15:59:29 [adjourned] 15:59:33 rrsagent, draft minutes 15:59:33 I have made the request to generate https://www.w3.org/2021/09/15-wot-td-minutes.html kaz 20:24:27 Zakim has left #wot-td