15:03:08 RRSAgent has joined #wot-td 15:03:12 logging to https://www.w3.org/2023/02/22-wot-td-irc 15:03:13 https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf#February_22.2C_2023 15:03:58 dape has joined #wot-td 15:04:19 mjk has joined #wot-td 15:04:37 q+ 15:04:48 meeting: WoT-WG - TD-TF 15:05:40 JKRhb has joined #wot-td 15:06:27 agenda: https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf#February_22.2C_2023 15:07:46 present+ Kaz_Ashimura, Ege_Korkan, Cristiano_Aguzzi, Daniel_Peintner, Jan_Romann, Luca_Barbato, Michael_Koster, Michael_McCool 15:09:09 ack k 15:11:25 mjk_ has joined #wot-td 15:11:49 q+ 15:12:23 topic: Minutes 15:12:42 https://github.com/w3c/wot-charter-drafts/files/10745556/WoT_Binding_2.0.pdf 15:14:34 -> https://www.w3.org/2023/02/15-wot-td-minutes.html Feb-15 15:14:40 topic: test related issues 15:14:57 i|test|(link to the slides above added)| 15:15:01 #1758 15:15:04 i|test|minutes approved| 15:15:56 s/#1758/subtopic: PR 1758/ 15:16:03 mm: "at risk" won't make it into the final PR anyway 15:16:08 https://github.com/w3c/wot-thing-description/pull/1758 15:16:18 q? 15:16:20 ack k 15:16:31 s/http/-> http/ 15:16:37 PR 1758 merged 15:17:01 s/1758/1758 PR 1758 - Updating at risk assertions in the main body/ 15:17:13 rrsagent, make log public 15:17:17 rrsagent, draft minutes 15:17:19 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 15:17:45 q+ 15:18:48 kaz: we have already published a list of at risk features 15:19:04 mm: this will be marked as an update 15:19:49 kaz: we can't put that information in the editors draft 15:20:09 mm: we could remove it from the main draft 15:20:21 kaz: it's just a memorandum for us 15:21:55 ... we need to publish a new CR to update this informaton 15:21:55 ack k 15:21:55 mm: we should delete the at-risk feature list from the draft 15:21:59 https://github.com/w3c/wot-thing-description/issues/1773 15:22:05 ege: created an issue for this 15:22:47 ege: implementers please look at this as a source of at-risk items 15:23:38 topic: big scope discussion for new charter 15:23:40 q+ 15:23:58 rrsagent, draft minutes 15:23:59 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 15:24:05 mm: recommend against a major redesign, suggest incremental improvement 15:24:05 ... for example, streaming 15:24:19 chair: Ege 15:24:24 mm: are there issues for all the work items? 15:24:24 regrets+ Sebastian 15:24:48 mm: for the charter we don't need a detailed list of work items 15:25:19 q? 15:25:20 ... we want to fix the major problems with small improvements 15:25:26 i/"at risk" won't/scribenick: mjk_/ 15:25:29 rrsagent, draft minutes 15:25:31 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 15:25:52 q+ 15:25:56 q+ 15:25:58 cris: I agree, there are some issues with forms and operations need work 15:26:15 ... maybe some things will need a lot of redesign 15:26:36 ... we shouldn't limit ourselves artificially 15:26:47 ack c 15:26:47 ... may want breaking changes 15:27:10 luca: agree, we may need to remove some items 15:27:42 ack l 15:27:46 ... we should first remove what isn't working and then discuss what can be added 15:28:13 cris: for the charter we don't need to be specific 15:28:27 i/Feb-15/scribenick: kaz/ 15:29:11 kaz: the title of an issue should be "high level scope discussion" for this discussion 15:30:01 q? 15:30:01 q+ 15:30:04 ... think about use cases to further extend industry deployment 15:30:13 ack k 15:30:30 mm: there should be a use case for each feature 15:30:38 s/an issue/this issue/ 15:30:39 +1 kaz 15:30:46 ... user stories also 15:30:53 s/discussion"/description"/ 15:31:08 +1 15:31:10 q? 15:31:14 ack m 15:31:19 s/think about/then regarding the content of this issue, we should think about/ 15:31:32 rrsagent, draft minutes 15:31:34 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 15:31:41 q+ 15:32:08 q+ 15:32:34 ege: some things are not use case motivated 15:32:56 ack cr 15:33:13 cris: we can't always rely on use cases 15:33:20 q+ 15:34:44 mjk: we have use cases but still have bugs 15:34:54 ... need general use cases on how to use TD 15:35:32 ack m 15:35:35 ege: this is the question; are there large issues 15:35:54 mjk: agree, there are bugs in addition to use cases 15:36:51 kaz: sometimes the use cases are difficult to write down 15:37:16 q+ 15:37:52 ... for example, TD without forms still needs a use case to inform how to implement it 15:37:56 ack k 15:38:27 q+ 15:38:36 mm: we can use the form "as a", "I would like to", "in order to achieve" 15:38:37 s/write down/write down. However, we still need use case description with user-side story for the required features./ 15:39:08 ege: we need to differentiate between new features and improvements 15:39:36 q+ 15:39:39 ack mc 15:39:48 +1 for user stories 15:40:06 ack cr 15:40:31 rrsagent, draft minutes 15:40:32 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html JKRhb 15:40:56 cris: high level scope requires some more imagination, but we still need user stories 15:41:21 ... agree that we need to create issues for these user stories and use cases 15:41:44 q? 15:42:05 ege: agree that there should be a document with some template 15:42:56 kaz: there are even user stories driving bug fixes 15:44:57 ack k 15:45:06 mk: agree, user perspective is part of both bug fixes and new features 15:45:25 sub-topic: naming discussion 15:46:16 ege: what do we call the different mechanisms involved in a binding? 15:47:13 ... tried to map out different concepts 15:47:37 q+ 15:48:09 ... core binding template document, protocol and payload bindings, profile documents, TD instances, and TM models 15:49:07 kaz: we need Ben's input to this discussion 15:49:48 https://github.com/w3c/wot-charter-drafts/issues/14 15:49:51 ege: wil invite Ben Francis and schedule a time slot in the meeting 15:50:08 ... int he meantime, please review and comment on this issue 15:50:16 s/int he/in the 15:50:42 topic: publication schedule 15:51:14 ... how many weeks are needed for review? 15:51:19 kaz: 2 weeks 15:51:46 s/for review/for the review by the WoT WG/ 15:51:53 s/... how/ege: how 15:53:08 ege: update to schedule 15:54:18 ... add 2 week review period for binding templates after 5 weeks 15:54:54 topic: technical discussions 15:55:02 rrsagent, draft minutes 15:55:03 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 15:55:19 sub-topic: json schemas for bindings 15:55:30 PR #237 15:55:45 s/big scope discussion/High-level description/ 15:56:02 q+ 15:56:28 q+ 15:56:33 ege: remove URI from the binding since it's in the context 15:56:34 q- 15:57:00 q+ 15:57:04 luca: how will JSON schema validate this case? 15:57:22 ege: it uses a string pattern 15:57:35 rrsagent, draft minutes 15:57:36 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 15:57:42 qq+ 15:57:57 luca: do we reject use of non-htv namespace? 15:58:11 s|PR #237|-> https://github.com/w3c/wot-binding-templates/pull/237 PR 237 - Add JSON Schema for HTTP| 15:58:24 cris: these is a limitation of JSON schema and variable keys 15:58:30 q+ 15:58:34 ack cri 15:58:44 ack luca 15:58:48 ack c 15:58:48 cris_, you wanted to react to kaz 15:59:03 luca: another option is to add a JSON-LD validation step 15:59:04 rrsagent, draft minutes 15:59:05 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 15:59:27 q? 16:00:27 luca: would like to provide a way to prevent conforming instances from breaking things 16:01:16 q? 16:01:18 ege: the consensus was that we should direct implementations to use the official namespace 16:02:04 dape: there could be a check on the external context 16:02:20 q? 16:02:31 ack dape 16:03:18 kaz: in 237 and 239 we have bigger question than binding templates, that also impacts TD itself 16:03:58 ege: agree, for example the geolocation issue is similar 16:04:49 kaz: maybe we could put the binding core back into the main TD document 16:05:03 q+ 16:05:08 q+ 16:05:23 ack k 16:06:14 luca: moving the description to the TD document makes sense and could be normative 16:06:32 ... if the registry is structured properly 16:07:04 cris: agree, it's a potential direction 16:07:09 react to 16:07:17 q? 16:07:21 ack l 16:07:22 ack c 16:07:28 s/react to// 16:07:57 ege: will create an issue for discussion 16:07:57 ack c 16:08:07 cris: is not a bad idea to merge protocol binding templates into td 16:08:20 ... there is no technical reason to have a separate document, just size 16:08:22 rrsagent, draft minutes 16:08:24 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html JKRhb 16:08:31 q? 16:08:54 ... but I am not sure if we can technically merge it a recomandation into another charter wise 16:09:08 mk: +1 only downside is the readability 16:09:26 mjk: +1, no technical reason except size 16:09:39 rrsagent, draft minutes 16:09:40 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:10:02 luca: we could refactor into TM as a separate document to reduce the TD size 16:10:03 luca: if the problem is the length of the main document, we can refactor it by moving TM out 16:10:08 q+ 16:10:09 q? 16:10:43 q+ 16:10:47 ack k 16:11:02 i/is not a bad idea/scribenick: cris_/ 16:11:04 rrsagent, draft minutes 16:11:05 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:11:15 mk: I think protocol binding can also be a sort of mapping between TM and TDs 16:11:20 ege: intresting 16:12:04 mk: we haven't yet document how to map abstract data structures into a payload structure 16:12:14 ege: we still need work there 16:12:26 mjk: the payload binding may need TM references 16:12:26 ... but protocols should be easy 16:12:43 subtopic: PR 250 16:12:54 ege: just mirroring TD spec 16:13:20 q+ 16:13:23 ... any objections? 16:13:29 ack m 16:13:49 dape: how you link the TD doc? are you point to the editor draft? 16:13:59 ege: yes, you are right I need to update it 16:15:24 ... ok now merging 16:15:40 ... also merging PR 237 16:16:07 subtopic: PR 241 16:16:10 rrsagent, draft minutes 16:16:11 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:16:17 ege: Jan worked on coap ontology and the render script 16:17:04 ... changing the render script 16:17:18 i|just mirror|-> https://github.com/w3c/wot-binding-templates/pull/250 PR 250 - Mention that the HTTP binding mirrors the TD spec HTTP Binding| 16:17:30 ... I'd prefer to merge it cause is a dependency of other PRs 16:17:48 jan: improves readability 16:18:14 cris: +1 16:18:53 rrsagent, draft minutes 16:18:54 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:19:00 subtopic: PR 246 16:19:18 i|Jan worked|-> https://github.com/w3c/wot-binding-templates/pull/241 PR 241 - Refactor render script| 16:19:42 ege: this a good update, but we need to wait for klaus review 16:20:00 i|this a|-> https://github.com/w3c/wot-binding-templates/pull/246 PR 246 - Generate CoAP vocabulary from RDF| 16:20:03 jan: it is a starting point 16:20:08 s/this a/this is a/ 16:20:09 ... we can regenerate the document 16:20:11 rrsagent, draft minutes 16:20:12 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:20:45 ... ontology still needs improvements and discussion about its future direction 16:21:08 ege: the index.html does not really contain substantial changes 16:21:20 ... it is more about tooling update 16:21:42 ... I also asked to add Jan as editor 16:21:58 +1 16:22:41 ... if klaus approves the PR we can merge it without group meeting 16:22:55 ... any other opinions? 16:23:03 ... ok thank you Jan 16:23:15 subtopic: PR 249 16:23:22 ege: I've just created it 16:23:53 ... it addresses an old temporary section about subprotocols 16:24:08 ... we need to discuss if we need it 16:24:17 ... the definition is a little bit fuzzy 16:24:23 q? 16:24:25 ... but I didn't update it a simply move it 16:25:54 ... I also added one sentence, explaning that can be explained in the binding document. 16:26:04 q? 16:26:13 ... i.e. longpolling should be explained in the http binding 16:26:33 ack d 16:26:33 q+ 16:26:37 ack d 16:26:45 ack dape 16:27:03 q+ 16:27:20 cris: I would create an issue to keep track of this new requirement for binding templates documents 16:27:41 ege: yes 16:27:59 ... coap is probably already mention it 16:28:30 ack c 16:29:15 mk: are we calling coap observe a subprotocol? 16:29:17 ege: yes 16:29:33 dape has joined #wot-td 16:29:34 mk: the meaning of subprotocol is ambiguous 16:29:38 q+ 16:30:09 ... for websockets it defines application protocols 16:30:17 q+ 16:30:21 ... we should bound what a subprotocol can or cannot specify 16:30:23 q+ 16:30:23 ack m 16:30:44 ege: for websockets is kind of straightforward 16:31:04 ... but for other protocols it gets weird because they have their semantics 16:31:23 mk: exactly, http has less degrees of freedom 16:31:44 ... which should figured out if the subprotocol meaning can be bounded 16:32:04 ege: websocket is like tpc in that sense 16:32:12 luca: I would remove subprotocol 16:32:33 ... the form operation is not reach enough 16:32:46 rrsagent, draft minutes 16:32:48 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:33:02 q? 16:33:06 ... I would remove it and jus relay on the protocol binding 16:33:35 s/ jus / just / 16:33:55 s/relay on/rely on/ 16:33:57 ack luca 16:34:03 luca: if it is just not just a tag 16:34:15 q+ 16:34:16 ... you need more vocabulary terms 16:36:14 ack m 16:36:57 q+ 16:37:26 ack k 16:37:59 cris__ has joined #wot-td 16:38:00 kaz: OK with once removing the subprotocol feature 16:38:20 kaz: we could remove sub-protocol but need to describe the websocket use in different platforms 16:38:30 s/kaz: OK with once removing the subprotocol feature// 16:38:37 i/we could/scribenick: mjk_/ 16:38:50 rrsagent, draft minutes 16:38:52 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:38:58 cris: we should see if we can extend the form description to provide these descriptions 16:39:17 ... there is also a transport protocol question like MQTT over websockets 16:39:30 ... we need a way to describe these also 16:39:52 ege: this applies to RPC protocols in general 16:39:53 q? 16:39:56 ack c 16:40:22 ack l 16:40:49 ege: back to PR 16:40:54 ... should we merge it? 16:40:57 ... I would like so 16:41:03 ege: back to PR #249 16:41:13 ... any objections? 16:41:16 ... any objection to merging? 16:41:20 ege: go 16:41:20 ... merged 16:41:40 subtopic: PR 251 16:41:48 scribenick: cris 16:41:51 ege: getting rid of the appendixes 16:42:05 scribenick: cris__ 16:42:39 ege: we had a long section for binding properties 16:42:57 ... but it explained good concepts 16:43:03 ... in a easy format 16:43:21 ... I kept thoes ideas 16:43:22 ... and moved in the right section 16:43:55 ... cris should review the PR because it has examples with the modbus 16:44:02 q+ 16:44:17 ... it explains how binding should really work 16:44:24 ... I won't merge it today 16:44:27 q? 16:45:23 rrsagent, draft minutes 16:45:25 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:45:57 i|getting rid|-> https://github.com/w3c/wot-binding-templates/pull/251 PR 251 - Temporary Section Reorg - Part 5: Interaction Patterns| 16:45:58 q? 16:45:59 rrsagent, draft minutes 16:46:00 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:46:17 cris: the examples are pretty concrete and they introduce a dependecy with the binding docs 16:46:32 q+ 16:46:35 ack cr 16:46:47 ... should we use a more abstract syntax? i.e. foo protocol binding 16:46:47 ege: I see your point, but then is too abstract 16:46:54 cris: yes indeed 16:47:16 kaz: I would like to see a diagram to explain the concepts better 16:47:31 +1 kaz 16:47:48 ege: it should go to the introduction 16:48:20 ... I can tackle it in the PR 16:48:20 q? 16:48:22 ack k 16:48:23 ... any other ^ 16:48:29 s/ 16:48:37 s/^/?/ 16:48:48 ege: mkj can yuo have a look at it? 16:48:55 mk: ok 16:49:17 ege: there is still a lot to discuss but we need to move to TD 16:49:23 Topic: Thing description 16:49:26 https://github.com/w3c/wot-thing-description/pulls?q=is%3Apr+is%3Aopen+label%3AEditorial 16:49:38 rrsagent, draft minutes 16:49:39 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:49:46 ege: I create a PR and then cristiano took over 16:50:08 ... the overall idea is to introduce captions 16:50:16 ... to make it easer to refer the tables 16:50:32 ... it create numbers 16:50:44 ... so that we can refer to table 16:50:45 ... there is no way to refer to the tables 16:51:03 s/mkj/Koster, / 16:51:08 s/can yuo/can you/ 16:51:28 ... you can't click the table 16:52:04 q+ 16:52:04 q+ 16:52:04 ... I think we can still merge it 16:52:33 i|I create|subtopic: PR 1772| 16:52:50 i|I create|-> https://github.com/w3c/wot-thing-description/pull/1772 PR 1772 - Add table numbers and captions using new respec option v.2| 16:53:02 q+ 16:53:06 ack c 16:53:46 cris: there is a workaround 16:53:52 ege: it is good enough 16:54:08 cris: about respec, I checked the code it easy to fix 16:54:33 dape: remember that figures are not clickable either. 16:54:39 ack d 16:54:39 ege: true 16:54:55 cris: +1 16:55:13 q? 16:55:16 ege: I would not stop the PR 16:55:37 rrsagent, draft minutes 16:55:38 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 16:56:15 dape: if we can fix it in the respec we can wait 16:56:30 cris: it depends how much they are fast to approve PRs and ship it 16:56:43 ege: I would merge the PR anyway 16:57:08 kaz: examples have clickable links, we can take them as examples 16:57:50 ... even though making resources clickable is good, but it is not worth too much work 16:57:53 ege: yeah 16:58:05 cris: yes, I agree 16:58:17 ege: I looked around and tables are not used that much 16:58:39 s/as examples/as examples. Also we can look into the other existing specifications by the other WGs./ 17:00:30 q+ 17:00:30 q- 17:00:30 ... I'd merge it and if there is an update we would have a follow up pr 17:01:01 dape: I'm not objecting, but currently some table has the caption but others don't 17:01:12 s/even though making resources clickable is good, but it is not worth too much work/However, please note that this is rather a "nice-to-have" kind of addition. So if it takes too long to see how to do that, we can simply live with the current status./ 17:01:42 rrsagent, draft minutes 17:01:43 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 17:02:09 present+ Tomoaki_Mizushima 17:02:10 ege: ok let's wait for the next week 17:02:30 ege: ok than we are done 17:02:34 ... any AoB ? 17:03:04 [adjourned] 17:03:09 rrsagent, draft minutes 17:03:10 I have made the request to generate https://www.w3.org/2023/02/22-wot-td-minutes.html kaz 18:09:52 kaz has joined #wot-td